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From the Editor 




V S appy New Year, 2007, and Happy MacWorkli The New Year is always an interesting 
time. Some use it as a time to start new projects and make a break from the old. 

V m Others use it as a time ro recount traditions and ground themselves with the 
m familiar We have both for you! 

fm really happy to announce a new r feature of MacTech: The MacTech Spotlight. Every 
month, well introduce you to someone in the Mat: community that is living the dream: making 
dieir livelihood by using a Mac! Or, it may be someone that has impacted the Mac community 
in a positive way. Like our first-ever entry: Christoph Nadig and Pascal Freihurgliaus. aka 
lx)botomo Software. You may have used their IPSecuritas application to setup an IPSee VPN, 
or, used something else diat they've created. Enough here; find out more on the back page, 
where you'll find The MacTech Spotlight from now on. 

My “automate everything* mantra is expounded on in the biggest way possible: Automate 
the real world, thanks to Andrew Turner. Andrew brings us part 1 of a two-part series on 
using your Mac to provide home automation - or any kind of real world automation in 
“Automate Your Place 

You frequently see mention on a mailing Its! that someone thinks RAID will provide them 
backup. Of course, there are immediate cries that, "RAID is not backup!!!" Or, could it be^ Tim 
Standing, VP of development for SoftRAID, explores how RAID can be part of an overall 
backup strategy in "RAID as Backup. 11 If you're reading this at Mac World, you can visit Tim at 
the SoftRAID booth (and 1 recommend you do). 

Readers of “Mac in the Enterprise, 11 lake heart: w hile the authors of that column have run 
into some issues, it will lx? returning soon. 

Of course, in addition to the articles above, we have: Ben Waldle's AppleScripting column, 
Mac in the Shell, more from Jose Cruz on customizing XCode in "XCodc Menu Scripts", Kool 
Tools reviews, a lesson in Ethernet's Jumbo Frames from Steve iVlodica and an interesting 
article from Mihalis Tsoukalos on R. a statistics language that you can apply to tasks that 
perhaps you didn't think of before. Whew! 

Ihank you for letting MacTech be one of your technology guides. Have a prosperous 2007! 


By Edward Maczak 
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AppleScript Essentials 


by Benjamin S. Waldie 

Introduction to 
Scripting 

i Microsoft Word 

_ _ ) 

Lately, there has l>een a lot of talk in the Macintosh 
community about Microsoft, and the forthcoming Office 12, 
One of Microsoft's big announcements is that they will be doing 
away with support for creating and running Visual Basic macros 
in the next version of Office, This leaves many people 
wondering how they will go about automating their Office 
applications. AppleScript to the rescue, I’m pleased to say that 
Entourage, Excel, PowerPoint, and Word are all AppleScrtpiablc. 

Office has supported AppleScript, for some time now, and with 
the release of Office 11 in 200-1, Microsoft actually completely re- 
implemented much of their AppleScript support, and also added 
AppleScript support for PowerPoint. Due to these changes, much 
of the AppleScript terminology in Word and Excel changed from 
previous versions. If you are currently using Office AppleScripts 
with a pre-2004 version of Office, then please lie aware that you 
will probably need to make some modifications to your scripts 
when you decide to upgrade your Office suite. Of course, this 
should go without saying when upgrading any scriptable 
application. Any time any application is updated, AppleScript 
terminology changes may lx: introduced. This is why ir is always 
a good idea to test your existing scripts with any new application 
version before implementing it into your live workflow. 

This month, we’re going to take a look at scripting Microsoft 
Word. Well walk through .some basic techniques for interacting 
with Word documents, and the content within those documents. 
Please note that all code in this month's column was written for and 
tested with Office 11 (2004). Therefore, if you’re using a different 
version of Office, please lie aware that the terminology you need 
to use may differ from that which I have used. 

Working with Documents 

Making a Document 

Making a new Word document is relatively straightforward. 

To make a new Word document, simply use the make 
command, as demonstrated here. 


tell application "Microsoft Word" 
make new document 
end tell 

—) document “Document1" of application "Microsoft Word" 

Notice that the result of I he make command is a reference 
to the newly created document. This reference may lie placed 
into a variable, if desired, for future reference in your script. 

Closing a Document 

Closing a Word document is also pretty straightforward. To 
close a Word document, use the close command. Optionally, 
you may specify a constant value (yes, no. or ask) for the 
close command’s saving parameter, to indicate whether the 
document being closed should be saved. The following 
example code will dose a document without saving it, 

tell application “Microsoft Word" 
close document 1 saving no 
end tell 


Opening a Document 

To open a Word document, use the open command, 
followed by a reference to the dtxument file you wish to open. 
Hie following example code will prompt the user to select a 
Word document file. It will then open that file. 

set theDocFile to choose file with prompt “E 1 lease select a 
Word document file:” 
tell application "Microsoft Word" 
open theDocRle 
end tell 

Please note that, in the example above, no result is returned 
by die open command. Since you will typically want your script 
to perform additional tasks on ihe newly opened document, you 
will need a way of referencing the document. There are a 
numlier of ways that this can lx* done. Assuming you know the 
name of the document, one way to do this is to retrieve a 
reference to tile dtxument using its name, for example: 

set theDocFila to choose file with prompt “Please select a 
Word document file;" 

set theDocName to name of (Info for theDocFile) 
tell application “Microsoft Word” 
open theDocFile 

set theDocument to document theDocNmne 
end tell 

> document "My Document.doc M of application “MicrosofI Word” 

If you're sure that the target document wifi be in the front, 
then another way you can reference it is by referencing the 
active document application property. For example: 

set iheDocFile to choose file with prompt "Please select a 
Word document file:" 
tell application "Microsoft Word" 
open theDocFile 

set theDocument to active document 
end tell 

> active document of application “Microsoft Word" 
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Take note that the result of the code above is a reference to 
the active document, This may work fine in most cases. 
However, be aware that, since it is not referencing a specific 
document, if another document is brought to the front, then the 
incorrect document may lie targeted. 

It’s also important to note is that, in Word, documents have 
an index number. However, this number does not indicate the 
front to hack position of the document, as it often docs in many 
other applications. Instead, it indicates the document's position, 
in the order that the documents were opened. In other words, 
if a document in the back was the last document to be opened, 
then the front document will not be document X. For this 
reason, when you want to target the front document in Word, it's 
always good practice to reference the active document. 

We have discussed a couple of ways to retrieve a reference 
to a newly opened document There are others, some of which 
are more robust, and I would encourage you to see if you can 
come up with some ways of doing this on your own. 

Saving a Document 

Saving a previously saved document into its original 
location is as simple as using the save command, as 
demonstrated here* 

tell application *Microsoft Word" 
save active document 
end tell 

However, suppose you want to save a document into a 
specific location, or in a different format? This is done using 
Word's save as command. This command has several optional 
parameters, which will allow you to specify die output location, 
formal, and more. To save a document into a specific location, 
make use of the file name parameter, as follows: 

net theOutputPath to (path to desktop folder as string) h “My 
Saved DOC.doc “ 

tell application "Microsoft Word* 

save as active document file name theOutputPath 
end tell 

To specify a format for the saved document, use the file 
format parameter. For example, the following code will save 
a document in RTF format: 

set thaOutputFath to (path to desktop folder as string) 6 "My 
Saved Doc■rtf" 

tell application “Microsoft Word" 

save as active document file name theOutpui Path file 
format format rtf 
end tell 

There are numerous other formats in which you can save a 
Word document, including Word template, HTML, web archive, 
and more. A complete list of supported formats can be found in 
Word's AppleScript dictionary, under Lhe save as command. 

Working with Document Text 

Working with Text Ranges 

In a Word document, text Is typically referenced using text 
ranges. A text range Ls a class of object that refers to a specific area 


of text, such as a single character, word, or paragraph, or all of the 
text within the document. Each text range has a starting and ending 
position. For example, a text range might represent character 1 
through character 5 of the document. The position 0 represents the 
absolute beginning of a document, just liefore die first diameter, so 
if you wanted to reference the first 5 diameters of a dixaiment, lhe 
text range would actually begin at position 0, and end at position 5, 
To reference text within a Word document, you must first 
create a text range. This is done by using the create range 
command. Thus command simply creates a reference for you, to 
the specified text content. Here's an example: 

tell application “Microsoft Word" 
tell active document 

set theRange to create range start 0 end S 
end tell 
end tell 

—) text range id «data iWrgOQOQ0OQQOQQOOOO5* of active 
document of application "Microsoft Word" 

l he result of the code above is a reference to a range of text 
within my document, in this case, characters 1 through 5. 1 can 
now access attributes of this text by referencing the range. For 
example, the following code will get Lhe text content within the 
range: 

tell application "Mlcrosuft Word" 
toll active document 

sot theRange to create range start 0 end 5 
content of theRange 
end tall 
end tell 
~> "APPLE" 

Getting the Entire Content of a Document 

In Word, the document class possesses a text object 
property. T his property references a text range representing the 
entire content of the document. For example: 

tell application "Microsoft Word 4 * 
tell active document 
content of text object 
and tall 
and tell 

> "APPLESCRIPT ESSENTIALS 

Introduction to Scripting Microsoft Word 
Copyright 2007 by Ben Waldie... 

Adding Text to a Document 

To replace lexl in a Word document, create a text range 
representing the text to lie replaced. Then set the content 
property of that range 10 the desired text For example: 

tell application "Microsoft Word" 
tall active document 

sat theRange to create range start Q and S 
set content of theRange to "TEST" 
end tell 
and tall 


Another way that text can lie added to a document is by 
inserting it. This is done by using the insert command. This 
command has a required parameter, text, which indicates die 
text to be inserted, It also has an optional parameter, at, which 
am !>e used to indicate the location before which the text 
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should be inserted. For example, the following code will insert 
the text TEST at the beginning of the active document. 

tell application "MicrosafL Word** 
tell active document 

set theRange to create range start 0 end 0 
insert text “TEST” at theRange 
end tell 
end tell 

This same tusk could also have been accomplished by 
setting the content property of a range representing the 
beginning of the document to the specified text. For example: 

tell application “Microsoft Word 1 * 
tell active document 

set theRange to create range start 0 end 0 
set content of theRange to "TEST* 
end tell 
end tel 1 

Working with Other Content 

It's also possible to add other types of elements besides text 
into Word documents via scripting. For example, you might 
want to insert a hyperlink, or an image. 

Adding a Hyperlink to a Document 

To add a hyperlink to a document, use the make command 
to create a hyperlink object. In doing so, you may specify 
property values for the hyperlink, including the text to be 
displayed the link URL, and the text range representing the 
location where the hyperlink should l>e created. For example, 
tlte following code will create a hyperlink to my company’s 
website at the beginning of the active document. 

tell application "Microsoft Word* 
tell active document 

set theRange to create range start O' end 0 
make new hyperlink object a) end with properties 1 text 
to displayAutomated Workflows. LLC". hyperlink 
address:"http:/ /vwv. automatedworkflows.com", text 
object:theRangeJ 
end tell 
end tell 

-> hyperlink object "http://vwv.automatedworkflows.couf of 
active document of application 'Microsoft Word" 

Adding a Picture to a Document 

Adding an inline picture to a document is similar to adding 
a hyperlink. Again, use the make command, but this time create 
an inline picture, rather than a hyperlink object. 
When using this command, you may spec ify property values for 
the picture, including the file name property, which should 
include the path of the picture file to be inserted (as a string). 
For example, the following axle will create a new inline picture 
at the beginning of the active document. 

Get thcPictureFaih to choose file with prompt "Please select 
& picture to insert:" 
tell application "Microsoft Word* 
tell active document 

set thefiarige to create range start 0 end 0 
make new inline picture at theRange with properties 
tfile name:thePicturePath as siring! 
end tell 


end tell 

> inline picture i of text range id edata 
iWrgOOQOOOOGOOOOOOOO* of document "Document!" of application 
"Microsoft Word" 

In Closing 

Now that we have discussed some basic interaction with 
Word, where do you go from here? We have really only 
scratched the surface, and there's a lot more that can Lie done. 
Take some time to explore modifying attributes of text, such as 
the font, point size, and color. Explore modifying document 
properties, adjusting header and footer content, inserting a table 
of contents, and much more. Take some time to explore Word’s 
AppleScript dictionary. You will find that it contains quite a lot 
of terminology, so it may actually take some time to become 
familiar and comfortable with it. 

For additional help getting started with Word, l>e sure to 
review the Microsoft Word 2004 AppleScript Reference 
documentation. This documentation can l>e obtained in the 
Resources > Development Center > AppleScript Resources for 
Office 2004 section of Microsoft's Mactopia website at 
hrtp://www.microsofLcom/mac/. You may also want to 
explore MacScri pier net’s ScriptBuilders, at 

hHp;//ser ipf builders, nel/, where you will find some 
AppleScripts for Microsoft Word, some of which may even be 
editable! 

IJniil next time, keep scripting! 

Till 
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Can RAID be used for Backup? 


Try splitting off a RAID drive as part of a backup strategy. 

By Tim Standing 


V 


Introduction 

It's 4:30 PM on a Friday and you gel a call that a server you 
administer is down. The users are going to be working through the 
weekend on a project which is due on Monday and are getting 
frantic because many of the files they need are on the server, ihis 
is the time when you'll see whether die backup of dial server is 
any good. The two criteria which matter to your users are: J) How 
fast can you get the server back online and 2) How old are the files 
you are restoring. These two items will determine whether the 
users think you are a miracle worker or just someone who tinkers 
with computers. This article descril?es how you can use minor 
volumes (ItAID I), as part of a backup strategy which can get your 
users to think of you as a miracle worker 

What is Backup? 

Before I get in trouble with die semantidsts reading this 
article, I need to define what 1 mean by “backup." For this 
article, I define backup as the process of protecting files or 
volumes from any disaster which can destroy data, 'Jhis includes: 
a hard disk failing, a user accidentally deleting a file, theft of a 
laptop, a file system getting corrupted, a vims infection, or your 
place of business burning to the ground (can you tell Fm a 
volunteer fire fighter). 

For me, a backup does not include saving multiple copies 
of a given file or volume for several years or saving copies of all 
the work you've ever done: I call that archiving. If you need to 
maintain an audit trail for financial or legal reasons or if you 
want to create an offline library of all the work you have ever 
created, you need some method of archiving your files. You 
should use software which allows you to archive to tape, for 
long term storage or simply copy files to CD-R or DVD-R media. 
In either case, the media should be stored in a safe deposit box 
at the bank or offsite in a fireproof vault. 

Traditional uses for Mirror 
Volumes 

Most people think of mirror volumes as providing 
protection only from disk failures. This is the “set it and forget 
it" attitude to RAID; you set up the mirror volume with two disks 


and don't touch it until one of the disks fails, Ai that point, the 
other disk provides data proteaion Ixxrause your files are 
redundantly stored on it. 

'tlie problem with the “set it and forget IF' approach to 
mirror volumes is that it only protects you from one of the data 
disasters listed above: hard disk failure. If you accidentally delete 
a file, the file is deleted from both disks. If your mirror volume's 
file system becomes corrupted, the corniption is written to both 
disks. Likewise if your building burns down or your Mac is 
stolen, you have no backup copy of your data to continue your 
business with. These are the reasons many people think that 
RAID cannot be part of a good backup solution. 

Backup Strategies which use 
Mirror Volumes 

Lets start by reviewing some of the features of a mirror 
volume. Once I he volume is set up, every write goes to all the 
disks in the volume. Therefore, every disk contains exactly Lhe 
same data; if the volume is bcxitable, every disk in the volume 
is bootable. At a later date, if a disk is added to the volume, a 
rebuild is started. This involves reading every byte of the volume 
and writing it to the new disk. Since this occurs at a layer under 
the file system, the copying is unaffected by whether a file is 
open, currently Ixing written to or locked by one of die users. 
At the end of the rebuild, all of the bytes on the newly added 
disk are identical to the bytes on all the other disks in the 
volume. This ensures that this new disk contains the intact copy 
volume, with the correct permissions, modification dates, boot 
data structures etc. After die rebuild completes, writes to the 
volume continue to go to the new disk as well as all die other 
disks in the mirror volume, ensuring dial die new disk continues 
to contain an accurate copy of the volume's data. 

So how can we use die fact that a RAID 1 volume has 
identical data on two or more disks as die cornerstone of a disk 
to disk backup strategy? As soon as you remove one of the disks 
from the mirror volume, that disk Incomes a backup copy of the 
entire volume. It is an instantaneous snapshot of all the data on 
that volume taken at the moment the disk is disconnected. If 
something happens to die original volume, you tan always 
attach the backup disk to another computer and mount the copy 
of your mirror volume, hi SoftRAID. we call the main disk of a 
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mirror volume, the primary disk and all the others are referred 
to as secondary disks. I will use this terminology for the rest of 
this article. 

Let’s look at a couple of ways that people arc using mirror 
volumes for backup and, what it protects them From. 

The Laptop User: 

First let’s look at a laptop user who travels a lot. She is out 
of the office most of the week and returns every' couple of days 
to attend meetings and work with the creative personnel to 
develop new ideas for clients. She has set up her startup volume 
as a mirror with the internal disk in her laprop as the primary 
disk and, an external FireWire disk as a secondary disk. Fvery 
time she comes back to the office, she plugs in tier secondary 
disk. The mirror volume starts a rebuild which copies all data 
hum her primary disk to her secondary disk. She can continue 
to use her laptop as the rebuild is in progress, (The* SofiRAlD 
driver minimizes the performance degradation during a rebuild 
by only copying bytes when the volume is not being accessed.) 
When the rebuild is done, she can unplug her secondary disk 
and leave the office on another trip. 

If anylhing happens to her laptop when she is on the road, 
it gets stolen or someone spills coffee on it, she is confident that 
she can get back to work as soon as she returns to the office. 
All she has to do is attach the secondary disk to a new computer 
and boot up holding down the option key. She can then select 
ihe secondary disk as her startup disk and boot up using a copy 
of the volume which was on her original laprop. The only data 
she will have lost are those changes which she made since she 
last connected her secondary disk. 

There are several advantages to tills backup method, 
compared to backup strategies which don’t involve RAID: the 
secondary disk is guaranteed to be bootable if the volume is 
bootable, the backup can take place regardless of which files are 
open or in use, the backup has very tittle impact on die 
performance of the Mac (usually less dm 1% of the CPU 
capacity when a rebuild is in progress), and there is no restore 
operation required before die backup can be used. 

The Desktop Mae User: 

The second user 1 w r ant to Ux>k at is the professional who 
relies on his desktop Mac for his business. He is a lawyer, 
developer, architect or other professional whose business relies 
totally on the contents of his computer. If he loses the files on 
his computer, his business will really suffer. In addition, the time 
lost when dealing with a failed hard disk is money down the 
drain. This user relies on a three disk mirror volume. His Mac 
has two internal SA I A disks which are used as the primary and 
secondary disks of a mirror volume. If one of the disks fails at 
any given point, the other one will take over and become die 
new primary disk, so his files are always protected from a hard 
disk failure. The third disk is an external FireWire disk which is 
also a secondary disk. It is stored offsite (either at home in a 
fireproof safe or at another safe location). Every Friday, he 


brings this third disk into his office and connects it to his 
desktop Mac, Once this disk is connected, a mirror rebuild starts 
automatically. He can perform this rebuild as he continues to 
use his Mac during the day. At the end of die day, when he shuts 
his Mac down, he disconnects his external secondary disk and 
returns it to its offsite location. This offsite secondary disk 
becomes his insurance against his building getting broken into 
or his building burning down, like the laptop user, if his Mac 
gets destroyed, he can just purchase a replacement Mac and then 
IxxH up from his external secondary disk. At most, he will use 
one week’s worth of work. 

The Server administrator: 

The last user 1 want to look at is a .server administrator, 
running a mail server on a XServe. She can’t afford to have the 
server go down due to a disk failure so she is also using a mirror 
volume with tw r o internal disks. She also can’t afford to lose a 
week’s worth of mail, so she has chosen a more aggressive 
backup strategy than die professional user. Her solution is a 
mirror volume with 4 disks, 2 internal, and 2 external FireWire 
disks. The two external secondary disks are normally stored 
offsite in a secure location. Every morning, the FireWire disk 
which contains the oldest copy of ihe volume is attached to the 
server and the mirror rebuild starts. Once the mirror rebuild has 
completed a few hours later, the external secondary disk is 
returned to its safe offsite location. This ensures that at least one 
copy of the data on the mirror volume is always at a secure 
offsite location. 

There is a SoftRAID user in lire military who has 8 external 
disks and performs his daily server volume lockup by using 
these 8 disks in rotation. This allows him to restore his server 
volume to any state it was in, during the last 8 days. 

Features in SoftRAID which 
facilitate backups 

SoftRAID, LLC, had users of its Mac OS 9 product who were 
using SofiRAlD for backing up their servers. We found out how 
they were doing their backups and listened to their requests for 
new features. These features were: the ability to make write 
protected copies of a mirror volume, and a mechanism to regulate 
the speed of a mirror rebuild. These requested features are 
designed to facilitate disk-tcxlisk and disk-to-disk-tcHape backups. 
They have been incorporated into SoftRAID 3 for Mac OS X. 

SoftRAID 3 allows users to spiiL a secondary disk off of a 
mirror volume as a read only copy of the volume; called a 
“Read-Only Secondary” volume. These disks then mount on the 
desktop as separate volumes which are write protected by the 
SoftRAID driver, Read-Only Secondary volumes are the most 
secure form of disk to disk backup as the user cannot mrxliiy 
these volumes once they are split from the original mirror 
volume. At a later date, the user can choose either: to add these 
Read-Only Secondary volumes back to the original mirror 
volume or to convert them to normal read/write volumes. 
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SoftRAlD 3 also allows the user to determine how a given 
volume will be used; called the volume optimization setting. 
This setting determines how much of the disk bandwidth the 
SoltRAJD driver will use during a minor rebuild. The possible 
settings are: Server - uses the disks as much as possible. 
Workstation - uses the disk 50% of the time, and Digital Audio 
or Digital Video - waits for many seconds of inactivity on die 
volume before performing any i/o for a mirror rebuild. 

Putting Theory into Practice 

I jet’s see how to setup a mirror startup volume for each of 
these users, I will be illustrating this by describing the steps you 
perform with the SoftRAlD application. You can perform some 
of these steps with AppleRAID, the RAID software build into 
Mac OS X, but you will have to resort to using terminal to nm 
the diskutil tool. 

Since a mirror volume Is just a volume with the identical data 
on more Lhan one disk, it is easy to convert a standard Apple Disk 
Utility non-RAID volume into a SoftRAlD mirror without erasing 
any of the Hies on the volume. The only changes which need to 
take place Lire: the volume's partition needs to be changed to a 
SoftRAlD partition, and a small SoftRAlD specific partition must be 
created to contain the volumes metadata. The SoftRAlD 
application performs these steps will) one menu selection. 

For security reasons, Mae OS X will not allow a disk s partition 
map to he modified if the disk contains mounted volumes. Tills 
means that all the volumes on a disk must be unmounted before 
the partition map can lie changed. If the volume is not your startup 
volume, this is easy; the SoftRAlD application can just unmount the 
volume, change the partition map, and then remount the volume. 
If the disk domains your startup volume, you have to start up your 
Mac using a different startup volume (e.g.: the SoftRAlD Startup CD 
or a volume on an external FireWire disk). Once the partition map 
has been changed, all the other steps of creating and managing a 
mirror volume can lie performed while your Mac has started tip 
this volume. 

Setting up a Mirror Volume for the laptop 
User: 

1) Startup your Mac using the SoftRAlD Startup CD. As 

l described above, you must use a different startup volume than 
the one on the disk you will be converting to SoftRAlD. You can 
use either Lhe SoftRAlD Startup CD (available for purchase from 
www.softraid.com), use an external FireWire disk which 
contains a startup volume or startup your laptop in target disk 
mode and connect it to a second Mac:. If you purchase the 
electronic version of SoftRAlD, you will have to use the second 
or third method for starting up your laptop. 

2) Launch the SoftRAlD application. If you did not use 

the SoftRAlD Startup CD, you will have to double click on the 
SoftRAlD application to launch it. 
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3) Convert your startup volume to a SoftRAlD volume. 

Click on the die for the internal disk in your Mac in the Disks 
column. You will see that it gets connected to a volume tile 
which represents your startup volume in the Volumes column. 
Select Convert to Soft RAID 3 in the Disks menu to convert 
your volumes partition to a Soft RAID volume partition. This 
process does not change any of the files in your volume, and all 
your volume's data will remain intact. 

4) Restart your Mac using your normal startup volume. 

Restart your Mac, so it is using the original startup volume. This 
will now be a Soft RAID volume and will have a SoftRAlD non- 
RAID volume icon. 

5) Connect the second disk you will be using for the 
mirror volume. Conner! a second disk to your Mac. This disk 
must be the same size or larger than the internal disk in your 
laptop. If your Mac contains a PowerPC CPU, you will have to 
use a FireWire disk as USB disks cannot be used for startup 
volumes. If you Mac contains an Intel CPU, you can use either 
a FireWire or USB disk. (Our experience has been that USB disks 
are much less reliable on Mac OS X than FireWire ones on either 
type of CPU.) 



6) Initialize the second disk. Click on the tile lor the 
external disk you have connected and select Initialize from the 
Disk menu. This tells the SoftRAlD application to create a 
partition map on the disk you have selected. You can specify the 
partition map type to use or let the SoftRAlD application choose 
the appropriate one by using the Default button (APM for 
PowerPC Macs and GPT for Intel Macs). The partition maps for 
all the disks of a given volume must be the same type. 

7) Convert the startup volume to a mirror. Click on the tile 
for your startup volume and select Convert to Mirror in the 
Volume menu. Then select the external disk you have just 
initialized. This will convert the volume to a mirror volume which 
contains two disks; the internal as the mirror primary disk and the 
external as the secondary one. It will also start a rebuild of the mirror 
volume. The rebuild process copies all of die data on the internal 
disk to the external one. Since a minor volume always .sends all 
writes to all the mirror disks, the two disks will contain identical 
volume data after the rebuild has completed, even if you have 
written files to the volume during the rehuild process. Both disks will 
continue to contain identical volume data as you use die volume, as 
long as they remain connected 

8) Wait for the mirror rebuild to complete. The rebuild will 
continue even if you quit the SoftRAlD application, 'ibis is because 
the rebuild process is actually handled by the SoftRAlD driver; the 
application just displays a progress indicator for the rebuild and 
allows you to stop a rebuild which is in progress. Once the rebuild 
has finished, the driver will display a dialog telling you that the 
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mirror volume Ls in sync, and all the disks contain identical data. 
Ihe driver also writes an entry to the system.log file when die 
rebuild completes. You can view the system.bg file using die 
Console application located in the Utilities folder. 

Leaving the office with your Laptop: 

1) Disconnect the external disk from your laptop. You can 

either shutdown your laptop, and then disconnect die external disk 
or disconnect it while your Mac is still running. The external disk 
liecomes a snapshot of your internal volume taken aL the exact time 
the external disk gets disconnected Note that if you disconnect the 
external disk while your laptop is asleep, your Mac may hang when 
you wake It I rack up. Hits is due to a bug in the kernel wiiich tails 
to keep track of external disks correctly if they are removed while 
the Mac Ls asleep. 

Returning from your trip and reconnecting 
your second disk: 

1) Reconnect the external disk to your laptop. When 
you return to your office and warn lo rebuild your mirror, you 
connect the external disk to your Mac. You can do this before 
you restart your Mac, when it is asleep or while it's running. 
When the Soft RAID driver detects this disk, it will recognize it as 
part of an existing mirror volume, and automatically start a 
rebuild. It will also display a dialog telling you that it has started 
the rebuild, and write an entry to the system.log file with the 
time the rebuild started. Once the rebuild has finished, the driver 
will display a dialog stating that the mirror volume is in sync, 
and all the disks contain identical volume data. It will also write 
another entry to the systemJog file. At no point do you have to 
run the SoftRAID application to complete the rebuild. 

Setting up a desktop or server Mac: 

The process of converting the startup volume to a mirror for 
a desktop or server is identical to that of a laptop. For these 
applications, the first two disks for a mirror volume are probably 
going to be internal or in die slide out trays in the case of an 
XSurve, Like with the laptop, once die startup disk lias been 
converted to SoftRAID, all of die remaining steps can be 
performed while the Mac is in use. You can have a server on line 
and have users logged in T while you initialize your second disk 
and convert your startup volume to a mirror. 

Adding additional disks to your Mirror 
Volume: 

You can add another disk to your minor volume at any 
time. Hits means you can add disks to your mirror volume as 
your backup strategy becomes more advanced or as your 
equipment budget grows. SoftRAID allows you to have up to 16 
disks associated with a given volume. (SoftRAID also allows up 
to 60 volumes per disk, and has been tested with over 100 disks 
connected to a single Mac.) 


To add another disk lo a mirror volume: 

1) Connect the new disk to your Mac, This disk must 
be the same size or larger than your mirror volume. For 
startup volumes, this disk must be on a bus which supports 
llooting (Le. not USB on a PowerPC Mac). It should also offer 
similar performance to the other disks in the volume. For 
instance, adding a FireWire 800 disk to a mirror volume, 
which contained SATA II disks would be okay, but adding a 
USB disk to tlie same volume would impair performance. 

2) Launch the SoftRAID application. 

3) Initialize this new disk. Click on the tile for the external 
disk you have connected, and select Initialize from the Disk menu. 

4) Add the disk to your mirror volume. Click on the tile in 
the Volumes column, which represents your mirror volume. Then 
select Add Secondary Disk from the Volume menu. You an 
then .select the newly initialized disk, and ii will be added to your 
mirror volume. It will also start a rebuild of the mirror volume. 

5) Wait for the rebuild to complete. The rebuild will 
continue even if you quit the SoftRAID application. For faster 
desktop Macs and servers, a mirror rebuild will take less than 
60 minutes for every 100 GB of volume size. 

Using Read-Only Secondary 
Volumes for Offsite Backups 

While a disk can simply be unplugged from a mirror 
volume to create a snapshot of that volume, the most reliable 
way of creating a copy is to split a disk off as a Read-Only 
Secondary volume. This creates a write protected copy of the 
original mirror volume on a single disk. When the disk is 
connected to another Mac for use with a tape backup system 
or to recover a group of files, die file system is locked, and 
none of die files on it can be modified. (The SoftRAID driver 
actually blocks writes to that volume, so even attempts to 
write to the volumes partition will fail,) At a later time, the 
Read-Only Secondary volume can lie added back to a mirror 
volume. When this happens, the SoftRAID driver will start a 
mirror rebuild to copy all the data from the volume back 
onto the disk, which has just been reconnected. 

The mirror volume on a server could therefore be 
backed using two or more external disks, both of which were 
split from die mirror volume to create Read-Only Secondary 
volumes. Every Lime a backup was required, the disk with 
the oldest Read-Only Secondary volume could be reattached 
and added back to the original mirror volume. This would 
start a mirror rebuild. Once the rebuild had completed, the 
disk could be split from the mirror volume as a Read-Only 
Secondary and stored offsite. 
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To Create a Read-Only Secondary Volume: 

1) launch the SoftKATD application. 

2) Spit one of the disks off as a Read-Only 
Secondary volume. Click on the tile In the Volumes 
column which represents your mirror volume. Then 
select Split Mirror from the Volume menu. You can 
then select the secondary disk you want to use as a 
backup copy of the mirror volume. Select the Read- 
Only Secondary option, and then dick the Split button. 
In 5 * 10 seconds, your disk will be split off as a Read- 
Only Secondary volume. 

3) Disconnect the disk containing the Read-Only 
Secondary volume. You can unmount the Read-Only 
Secondary volume and disconnect the disk from the 
Mac. It is now ready to be stored offsite. 

To Add a Read-Only Secondary Volume 
back to the Original Mirror Volume: 

1) Attach the disk containing the Read-Only 
Secondary volume. Connect the backup disk with 
the Read-Only Secondary disk to your Mac. The 
volume will automatically mount on the desktop. 

2) Launch the SoftRAID application. 

3) Add the Read-Only Secondary Volume back 
to the Original Mirror Volume. Click on the tile in the 
Volumes column which represents the Read-Only 
Secondary Volume. Then select Convert Read-Only 
Secondary Volume from the Volume menu. Use the 
default setting of Add back to original Mirror 
volume, and dick the Convert button. The Read-Only 
Secondary volume will be added to the original mirror 
volume in 5 - 10 seconds, and a rebuild will be started. 

Recovering from Data Disasters: 

All of the data disasters you can encounter can be 
divided into two types: those where you need to 
restore an entire volume intact, and those where you 
only need to restore a group of files or folders. When 
you are restoring an entire volume, you do not have 
access ro the original volume or cannot trust its 
contents. This would happen if your Mac was stolen or 
if all of the mirror disks inside your Mac were 
destroyed by a power spike. You would also want to 
restore an entire volume if you had a corrupted 
volume or your Mac was kernel panicking each time 
you started up. 

if you are restoring a group of files or folders from 
a volume, chances are that the original volume is still 
fully functional. In this case, you only need to copy a 
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file or group of files which were accidentally erased to 
your mirror volume or another safe place. 

Recovering an entire volume: 

1! your backup disk contains a Read-Only Secondary 
volume, you will have to convert it to a normal volume 
before you can use it as a startup volume. You can do this 
using the SoftRAID Startup CD or by connecting it to 
another Mac, and running the SoftRAED application. To 
convert a Read-Only Secondary volume to a normal 
startup volume: 

1) Launch the Soft RAID application. 

2} Convert the Read-Only Secondary volume 
to a non-RAID volume. Click on the tile in the 
Volumes column which represents the Read-Only 
Secondary Volume, Then select Convert Read-Only 
Secondary Volume from the Volume menu. Select 
the Convert to non-RAID Volume, and click the 
Convert button. The Read-Only Secondary volume 
will be converted to a non-RAID volume, and will 
mount on the desktop. 

3) Startup the Mac using your backup disk. 

Attach the backup disk to the replacement Mac you 
want to use. Then startup the Mac, and select the 
backup volume as your startup volume. 

tf your backup disk was simply disconnected from the 
Mac, and does not contain a Read-Only Secondary volume, 
you should connect iL to different Mac before using it. If you 
are using ihe original Mac, you should disconnect all of the 
original minor disks or the SoftRAED driver may try and start 
a mirror rebuild, possibly overwriting your backup of the 
volume. 

To startup using a backup disk which 
contains a snapshot of the mirror volume: 

1) Connect the backup disk to the Mac you want 
to use. Make sure the replacement Mac you are using can 
be started up using the partition map type, and Mac OS X 
version on the backup disk. 

2) Disconnect any disks which were part of the 
mirror volume. Make sure all of the disks winch were 
used with the original mirror volume are disconnected 
from the Mac These disks contain copies of the 
corrupted file system, virus infection or other malady 
which is causing your Mac to kernel panic. If they are 
connected when you try and startup from the backup 
disk, the SoftRAED driver may start a mirror rebuild, 
possibly overwriting the backup disk with data from 
the corrupted volume. 
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3) Startup the Mac using your backup disk. 

The startup process will take 15 seconds longer than 
normal, the first time. This delay will occur when you 
see the grey apple logo. Tills delay is normal, and is 
caused by the SoftRAID driver waiting to see if any of 
the other disks in the mirror volume will appear. If 
they don't appear in 15 seconds, the SoftRAID driver 
will use the backup disk for the mirror volume, and 
start the Mac, 

Remember that the usual startup disk rules 
apply: You can’t startup an Intel Mac from a disk with 
an A PM partition map, and similarly you can't start up 
a PowerPC Mac from a disk with a OPT partition map. 
In addition, the version of Mac OS on the backup disk 
must be able to boot the Mac you are trying to startup. 
So, don't try and startup your new replacement Intel 
XServe with the backup disk from your G4 XServe, 
which was running Panther Server 


Recovering a group of files or folders: 

If your backup disk contains a Read-Only 
Secondary volume, you can just connect the disk to 
your Mac, and copy the files and folders you want off 
of the volume. The volume will have the same name as 
your mirror volume, but the icon will have a small 
paddle lock on it. 
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* CodeWarrior 
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All interfaces ships with a Well suited pre- and after 
complete SDK, drivers, sam- sales eMail-support is avail- 
pie apps and documentation, able as a matter of course. 


If your backup disk was simply disconnected from tile 
Mac, and does not contain a Read-Only Secondary volume, 
you should connect it to different Mac and copy the files 
off using this second Mac, If you connect this backup disk 
to a Mac, which contains the original mirror volume, the 
SoftRAID driver might start a rebuild which would 
overwrite die files you are trying to recover. 

The Advantages and 
Disadvantages of using Mirror 
Volumes for Backup 

There are several advantages to using mirror volumes 
as pait of a backup strategy: D'lTie backup preserves all 
permissions, file system Sinks, and aliases perfectly. 2) 
Open and locked files can be backed up. 3) There is no 
restore step. 4) It takes less than 5 minutes to get a server 
back on line from the backup disk. 5) It is easy to see if 
your backup worked. 

There are a few disadvantages to using a mirror 
volume for a backup: l)The backup disk must be the 
same size or larger than the size of the volume. 2) The 
backup time is dependent on the size of the volume, 
not the amount of data on the volume. 

Recovering the Server on Friday Afternoon: 

Let’s revisit the scenario I started this article with. If 
you had hacked up this server by creating backup disks 
containing Read-Only Secondary volumes, you could 
have the server back up within 10 minutes, 'Hie hardest 
part would be getting a replacement Mac, the backup 
disk, and the necessary cables together. All you would do 
is convert the Read-Only Secondary volume to a non- 
RAID volume, and then set it to be the startup volume on 
your replacement Mac. You would then have a server 
which was exactly the same as die original server (at the 
time you created the backup). 

If you had backed up that server with a more 
traditional type of backup software, how far into the 
restore process would you be in 10 minutes? 

Conclusion 

This article showed you viable ways to make RAID 
a part of your overall backup strategy. While its 
original use concerned high-availability, being able to 
split off an in sync mirror volume opens up a new 
avenue of data protection. 
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Xcode Menu Scripts 

u 

Creating and installing Xcode menu 
scripts using Xcode 


By Jose R.C. Cruz 


Introduction 

Xcode is the de facto development environment for the MacOS 
X platform. Its Interface Builder allows user interfaces to lx? easily 
built and linked to the appropriate code. Its use of GCC enables ii 
to support various languages, even exotic ones such as Haskell 
Also, its build phase system is much easier to understand and 
maintain than the more kitchen-sink approac h of makefiles. 

Another unique feature of Xaxle is its Script menu. It allows 
developers to add scripts that will customize or enhance die Xcode 
environment These sc ripts can perform spec ific tasks on a selected 
text or file, or even on the entire project. They can also enable 
Xaxle to interact with other third-party tools. 

Tills article will focus on what constitutes an Xcode menu 
script. It will demonstrate how to use Xcode to write and install a 
menu script. It will also provide a number of script examples dial 
developers may find useful. Readers are assumed to have a working 
knowledge of writing basic shell scripts. 

To complement this article, tile installer package, XuxleMenu, 
Is available for download from the MacTech website, lire package 
contains the project and file templates drat will help readers write 
iheir own menu scripts. It also contains the example scrips shown 
in this article, as well as die Xcode project used to create them. Tire 
package can lx? downloaded at die following LULL: -place URL here-. 

The Xcode Menu Script System 

The Script menu is the central launch point for all Xcode 
menu scripts. Each item on the menu corresponds to a script 
stored inside the Xcode scrip! directory. The directory itself 
is located on the OS X bool volume at the following path; 
/Library/Application Support/Apple/Developer 
Tools/Scripts/10-User Scripts. 

Figure I shows the structure of the Xcode script directory, 
and its default contents. Notice that the 10-User Scripts 
directory is further subdivided into 6 other subdirectories. 
Each subdirectory gathers the scripts in terms of their general 
function. For instance, the 20-Search subdirectory contains 
those scripts that perform a search function. 
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Figure I. The Xcode script directory. 


The numlxits before the names of each subdirec tory and script 
show their positions on tlie Script menu. Each suIxJireciory is 
displayed as a submenu of that menu. A menu separator is defined 
using an empty file whose name consists of a numl>er followed by 
three dashes. For instance, an empty file with a name of 15- in 
the subdirectory 50-Text places a menu separator between die 
scripts 10-sort, sh and 20 uniq* sh. 


Anatomy of a menu script 

In many ways, an Xaxle menu script Is similar to a basic shell 
script Both are text files, and lx)th can he written in any one of the 
popular shell languages such as sh t bash, and Perl However, a 
shell script is usually stored as an ASCII text file. It usually receives 
iLs input from std i n, and sends its output to std out. On the other 
hand, an Xcode menu script Is stored as a tfTF-8 text file. Il often 
receives its input from the aitive source file. Where ll sends its 
output will depend on how the script is configured. 

Figure 2 shows tlie basic structure of a typical Xcode menu 
script. Like die shell script, ii starts with a declarative header, 
also known as the she-bang. This header indicates the 
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command “line tool that will interpret and execute the .script, ft is 
also used to pass command-line options to the tool Make sure 
to check that the tool is correctly installed on the MacOS X 
platform. Otherwise, Xcode will return an NSTask error message 
stating the absence of the tool, It will also terminate the 
execution of the rest of the script. 

For example, if the declarative header reads as 
//] /bin/bash, the bash tool will execute the menu script. If it 
reads as /usr/bin/python t, the python tool will 
execute the script. The tool will also display warning messages 
for any inconsistent tabs present in the script. 




i 

afOumenu li*t 




ftcrlpi tsotfy 


Figure 2. Structure of a basic menu script (sortsh). 


Right after the declarative header is the arguments list. This list 
defines the input source for the .script as well as its output 
destination. Also, it is where the script is assigned with a menu name 
and a shortcut key. 

Finally, the last part of the script is the script Itody, This body 
consists of one or more command statements that will perform 
the specified menu action. The commands used by these 
statements depend largely on the command line tool chosen for 
the task. Consult your uxiFs user manual for more information 
about its commands. 


Known shortcomings 

A number of issues limit the capabilities of an Xcode menu 
script. The mast notable one is that the Script menu Is enabled only 
if a source file has l)ecn selected Otherwise, it is disabled even in 
Lite presence of an active Xcode project. This lsehavior prevents a 
script from performing project-oriented tasks such as backups* and 
SC_M check-ins and checkouts. 

Also, a menu script can only interact with the Xcode user in a 
limited way. Often, it is in the form of dialogs generated using the 
StandardsAdditions scripting library. For a menu .script to 
access and display any one of these dialogs, it has to use the 
osascript tool 

But a menu script cannot use the osascript mol as its 
command-line tool. If its declarative header is 
#l/usr/bin/osascript, the script will only generate cm)ts 


when executed by Xcode. This prevents the script from being 
written in pure AppleScript. 

The Xcode Menu Script 
Components 

Xcode provides a number of built-in arguments that can 
appear in the arguments list. To prevent the command-line tool 
from interpreting them, these arguments are enclosed within a 
%%%(«)%%% delimiter. The most important argument is 
FBXName. Use this to assign a menu name to the script. That 
name is displayed on (lie Script menu each time it is rebuilt. 

Also equally useful is the PBXKeyKquivalent argument. 
Use this argument to assign a keyboard shortcut to the script. 
The shortcut itself consists of a modifier key followed by a 
single alphanumeric character. Assume, for example, Lite 
following entries in the script's arguments list. 

§ Script \%%X 

f %%% | PBXKeyKqui valent%%% 

This means the script will have a name of Test Script on the 
Script menu. It can also be invoked by pressing the <CMD> key 
together with the <B> key. To execute the script, either its name 
is selected from the Script menu, or its keyboard shortcut is 
typed on the keylx>ard. 

Other supported modifier keys include <0pt> 
(represented by a tilde, ‘~ , ) J <Ctrl> (represented by a caret, 
‘ A ’), and <Shift> (represented by a dollar sign, $'), Make sure 
to assign unique shortcut keys to each menu script. Otherwise, 
the wrong script or operation may l>e invoked it' that shortcut is 
used elsewhere. 

Handling input data 

To supply data to the menu script, Xcode provides the 
built-in argument, PBXinput. This argument is the functional 
equivalent of the stdin file descriptor. 

The source of data for the PBXinput argument comes from 
the active source file. This will be the file being edited in the 
Xcode's text editor pane. For instance, if the test. c file is Ixring 
edited, data for the PBXinput argument will come from that file. 

The PBXinput argument takes one of three possible values. 
The Selection value tells Xcode to use the currently selected 
text as the input data for the menu script Conversely, the 
A1 IText value tells it to use the entire source text as the input 
data. Finally, die None value tells Xcode to provide no data to the 
script. The same also happens if the PBXinput argument is 
omitted from the menu script. 

Another way of providing input data to the menu script is 
through the built-in argument, PBXArgument. This is used to 
pass parameters to the menu script. It performs the same 
function as a command-line option. 

A PBXArgument can only have a single parameter. Bul a 
menu script can have more than one PBXArguments. To access 
the first nine PBXArguments, use the positional variables $1 to 
$9, with $1 corresponding to the very first one. If there are more 
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than nine PBXArgumenis, make sure to enclose the positional 
number within a pair of braces* For instance, to retrieve the value 
of the 25th FBXArgument* use the variable ${251, 

Assume, for example, the following entries in the script’s 
arguments list, 

! %%% [ PBXArgUPnent”- r J %%% 

%%XtPBXArgumein--zm% 

If %%%l PBXArgimeiit- el%%% 

'ITie positional variables $1, $2, and $3 will tlien return their 
respective values of - r, z t and -e* 

Handling output results 

Xcode also provides the built-in aigument, PBXOulput, to 
handle the output results of a menu script, Hiis argument Is the 
functional equivalent of die stdoul file descriptor If die menu 
script does not have the PBXOutput argument, any output results 
it generates will be simply discarded. 

The PBXOutput aigument can have one of seven possible 
values. Each value determines how the output results are to lie 
handled by Xcode. For instance, die Discard value tells Xcode to 
ignore any results generated by the menu script. This has die same 
effect as not adding a PBXOutput aigument to the script. 

The next three values tell Xcode how to display die output 
results onto the active source file. The ReplaceSelection value 
replaces die currently selected text with the output results. On die 
other hand, die IasertAfterSelection value appends the results to the 
selected text. Finally, die ReplaceAllText value replaces die entile 
source text with the results. Note dm die resulting change in the 
source texi Is not permanent* Closing Undo fn>m die Edit menu 
can still restore the original text. 

Hie Separate Window value, on die other hand, tells Xcode to 
display the output results in a separate window* Ai the time of this 
writing, however, Xcode does not display the results in a separate 
document window. Instead, it uses a modal dialog to display those 
results. Hopefully, future versions of Xcode will address this issue by 
providing Ixith display options. In the meantime, see the script 
example shown in listing 2 for a gtxxl workaround. 

The next useful PBXOutput value is the Pasteboard value. 
It tdls Xcode to store the output results onto the clipboard 
buffer. Choosing Paste from the Edit menu then places the 
results onto any editable text window. 'Ihe results remain in the 
clipboard buffer until the next Cut or Copy ojieratiun replaces 
them* They can also be replaced by another menu script if its 
PBXOutput is also set to Pasteboard, 

The lasl PBXOutput value is the AppendToAllText 
value. This value tells Xcode to place the output results at the 
very end of the active source file. However, this feature is 
broken in version 2,3 of Xcode. Any output results from a menu 
script are not displayed anywhere on the source file. The 
README files for both Xcode 2/1 and 2,4J also showed no signs 
of whether or not this bug is fixed. 

The macro variables 

Xcode provides a number of built-in macro variables that 
can be used in a menu script, It then replaces these variables 


with their actual values prior to script execution* Use these 
macros to simplify various aspects of a menu script* Make sure 
to enclose each macro variable within the %%%(.**!%%% 
delimiters. This will prevent the command-line tool from 
accidentally interpreting them. 

The first macro variable is the PBXTextLength macro. It 
returns the total number of characters contained in the active 
source file. The character count also includes control characters 
such as newlines (QxOd) and tabs (0x09). In short, this macro 
variable represents the size of the source file in bytes. 

Three macro variables are used for processing a text 
selection. Hie PBXSeleetionStart macro returns the 
number of characters before the start of the selection. 
Conversely, the FBXSeleetionEnd return the number of 
characters from the start of die file up to the end of the 
selection* Finally, the PBXSelecticmLength returns the 
number of characters contained by the selection. Its returned 
value is equal to the difference between FBXSelectionEnd 
and PBXSeleetionStart. 

Figure 3 shows how these three macros are interrelated 
with each other. This example assumes that the active source file 
contains only the live-word phrase shown. Note that, in this 
example, the selected text is highlighted in grey. 

PBX &elec11onLangth 
PBXSelect LonStart / 

JLj —> 


Lorem ipsum dolor sit amet 

k 

tmselsctioatoui 


< 

PH 

Figure 3. Macro variables on a text selection* 

On a related note* the built-in macro PBXSn lection sets the sum 
and end of a selection, Jt is used to select a portion of ihe output 
result. For example, assume that a menu script generates the 
following output* 

echo "Loren ipsuin " 

echo "U%(PBXSelectionm%dolor " 

echo "%%%! FBXSelect ion t ait atoet" 

If the PBXOutput argument is set to use the active source file, 
die word dolor will be selected on that file* However, make 
sure to use die PBXSelection macro in pairs. If Xcode doe*s 
not find a matching PBXSelection macro for a previous one, 
it will not perform the text selection. 

There are also two built-macros that return a file path. 
The first one, PBXFileFath, returns the absolute file path 
of the active source file. The path is returned as a string 
value, and is rendered as a Unix file path. Use this macro 
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to manipulate the file, its contents, or its directory at the 
shell level. 

The second macro is PBXU till ityScriptzs Path, This 
macro returns the directory path for all the utility scripts bundled 
with Xcode, By default, it returns the path as 

/ Systtti/ t*i br a ry f Pri vn t rF rotscrwu r ki! / DevToo 1 b 1 nte r f a c e. f r a i*fwo r k * 
f %1 i tySr ri pti. 

Use this macro to refer to any one of the utility scripts, which 
will lie discussed next. 

The utility scripts 

In addition to built-in arguments and macros, Xcode also 
comes with a number of utility scripts. These scripts are primarily 
used to add modal dialogs to a menu script Xcode users can 
then interact with the menu script through these dialogs. 

The utility scripts use the osascript command-line tool 
to generate their modal dialogs. This tool sends AppleScript calls 
to the StandardAdditions library, which then displays the 
desired dialog. When a user interacts with the dialog, the Ux)l 
returns the results to stdout as a string. If the user cancels the 
dialog, the tool sends an empty string to stdout and a 
cancel la I k > n message (error -128) to s tderr. 

At tile time of this writing, Xcode comes bundled with five 
utility scripts, 'line first script. AskllserForApplicationDialog, 
displays a list of all applications present on the MacOS X 
volume. It requires two string parameters; the dialog title and the 
prompt message. For example, 

REI‘Ly* k %%%( FSXUtilityS<:riptEpflthl%11£/Ai:kB^i’rForAppnt8Utnil>i4lo| ^ 
"Application List* ""Pick an appllcation" 1 

displays a dialog with the title Application List and the message 
Pick an application. When a user selects an application, the 
script returns the absolute file path to that application as a string. 
In the above example, the returned siring is stored in the shell 
variable REPLY, 

The second utility script is the AskUserForSiringDialog 
script. This script prompts the user for an input string. It takes a 
single string parameter, which Is the default input value. For 
example, the following statement 

REPL¥“' %%%(FBXUtilityScriptsFath IX^/AskUserForStringDiaiog n 
"untitled"' 

should display an input dialog with the siring untitled as the 
default value. After the user types in a string and presses the 
Enter burton, ihe script returns the string value to the menu 
script. However, this utility script has one notable flaw. Its 
prompt message Is set to the default string value of Enter your 
name, anti it cannot be changed. For a good workaround, see 
the script example shown in Listing 4. 

The rest of the utility scripts are used for I/O interaction. The 
AskUserForlMstingFileDialog script prompts die user to select a 
file from the MacOS X volume. It takes a single string parameter, 
which is the prompt message. For example, the statement 

REPLY* 3 ' \%X (FBXUt! 11 tyScciptsPath I %flX/AskUserFor!Ej!ieti ngFi IcDi a log “> 


displays the dialog with the prompt Choose a file to lie edited. 
When the user selects a file, the sen pi returns the absolute file 
path to rhat file as a string. 

The dialog displayed by this script uses -/Documents as 
its default directory. It shows any files and directories that are 
hidden or invisible. Also T it resolves links to other directories. 
Bui it will not do die same for links to other files, treating them 
instead as actual files. 

The next I/O utility script is the AskUserForFolderDialog 
script. This script prompts the user to select a directory from the 
MacOS X volume. It also takes a single string parameter for its 
prompt message. For example, the statement 

REPLY”' %%% [ PBXlIt 11 i ty Sc r i pt fiPath} %1%/AekUs e rForFoldeiDi a log 
"Select a destination"" 

displays the dialog with the prompt Select a destination. When 
the user selecLs a directory, the script returns the absolute file 
path to that directory as a string. 

'Ihe dialog displayed by the script allows users to create a 
new directory, and Lo select it as well. It also resolves links to 
other directories. But, it w ill not display any directories that are 
hidden or invisible. 

The third I/O utility script is the AskUserForNewFile Dialog 
script . Tliis script prompts the user to select the directory where 
a new file can be stored. It also prompts for a name to I've 
assigned to that file. The script takes two string parameters: one 
for the prompt message, the other lor the default filename. For 
example, die statement 

REFLY=*m[FBXU ti11 tyS c r1ptflPa t hI%1%/AsfcUs p rffi rNcwFi1eBla1og - 
"Save the backup as" "backup.file*' 

displays the dialog with the prompt Save the lockup as, and a 
default filename of backup.file. If a file exists with the same name, 
the dialog will display a warning alert. Also, once the user lias 
selected a directory and a filename, the sc ript returns the absolute 
file path to that new file. It w ill not, however, create the file. 

Creating an Xcode Menu Script 

The Xcode project template 

Often, writing an Xaxle menu script means using a third- 
party text editor. But why not use Xcode itself to write and install 
a menu script? The Xcode project template, Xcode Menu 
Script Action, is created primarily for this purpose. This 
template, as well as other support files, are available as pan of 
the XcodeMenu installer package. 

The template itself contains a starter script named 
my script, sh. Tills script has the basic: arguments list shown in 
Figure 2. Modify this list to the appropriate settings tor this script. 

Itie script also has a custom list containing two arguments. 
These arguments determine how the script is to be installed. The 
first one, USRDir, specifies the subdirectory that will contain the 
menu script. This subdirectory is then created inside the Xcode 
script directory. 
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it's cross-platform-available for your PC users, too. IPs easy to install and manage and 
simple for your employees to understand and use. 

Using Now Up-to-Date & Contact you can schedule meetings for multiple users, view 
multiple, simultaneous calendars, and reserve rooms and resources. You can shore 
contact information about your customers, prospects and vendors. And using our Free 
server software you can set it up in minutes and share with users in the office or from 
anywhere with an internet connection. 


.£qjl 866-5#J^55$kar fiirhdfl us at mactech@nowsoftwarexom 

and we'll send you our free evaluation kit, including the book that will 
make it all easy* "Take Control of Now Up-to-Date & Contact" from 
Take Control books! 


Copynghi © 200ft by Now Sofiwars, Inc. Alf fa^htsi ftwrvod. Now Up to Dale and Now Con kid ora ragistafnd rrndanKrrik* ^ Now Sotowow, Inc. Mac and the Mac bga ara irarfH marks, of Apple Compmar, Inc., 
rarfiiiBTod m tfie- U.S, and olher courrtnei. All orfw Irndsmorks. aeinawledgad. 











The second argument is USRName* This specifies a unique 
filename for the menu script. It also specifies the two-digit 
number that determines the script s position on the Script menu. 
Always make sure to assign a mo-digit number to the menu 
script* Also, make sure to add a dash between the number and 
the script’s filename. Failure to do either one rentiers the script 
inaccessible from the Script menu. 

For example, assume that a menu script has the following 
entries in its custom header. 

# Custom User Script Info - 

# %%%|USR0ir*75-CyS Control I %%% 

# %%%tUSKNainc B 0!} cvEtof3ckup.ghn«%% 


entry named Test Scripts, and that submenu should have a single 
menu item named My Test Scripi (Figure 5). 
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Xcode first checks to see if the subdirectory 7 5 - CVS Control 
exists in the script directory* If it does not, Xcode creates a new 
subdirectory with that name. Next, Xcode copies myscript *sh 
into that subdirectory. It then renames the copy as 05“ 
cvsbackup * sh. 

The Xcode project can also have multiple scripts. Each 
script can have its USRName set to its source filename, as long 
as the required two-digit number and dash precedes that name. 
Each script can share the same USRDir subdirectory as the 
other scripts. Alternatively, it can have its own USRDir 
subdirectory. 

Using the project template 

To create a new Xcode menu script project, choose New 
Project from the File menu. Then, from the Project Assistant 
dialog, select Xcode Menu Script Action (Figure 4) and press the 
Next button. Assign a new name to the project, and select the 
directory to store it. Click on the Finalize button to create and 
save the new project. 

To install and test the default source script, choose Build 
from the Build menu. If the build process generates no errors, 
choose Reset Menu from the Script menu* This will cause the 
menu to update its list of menu items. After a second or two has 
elapsed, click on the Script menu. There should Ik 1 submenu 



( Caned T Pmtkota ^ 


Figure 5. A single menu script 

To add another source script to the Xcode project, choose 
New File from ihe File menu. Then, from the New File Assistant, 
choose Menu Script File and click on the Next Button (Figure 6). 
Assign a new name to the file, and the project and target to 
which it should belong. Click on the Finalize button to save the 
file, and have it added to the project. 
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Figure 6. Selecting the file template. 


Choose Build from the Build menu to add the new menu 
scripts to the ScripL menu* Then choose Reset Menu from the 
Script menu to update its list. The submenu should now have 
two menu scripts as shown in Figure 7. 
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Figure 4. Selecting the project template. 


Figure 7. Two menu scripts. 
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Xcode Menu Script Examples 

Counting the number of lines 

Listing I shows one of the simplest menu scripts possible 
for the Xcode environment* This script uses the wc tool to count 
the number of lines in the source file. It then displays the 
resulting count using a modal dialog. 

Listing 1. Count the number of source lines 
(lineCounLsh). 

# - PB User Script Info * 

$ %%.% [ PBXMatne=Coiint the nuwbet of source lines 

it %%% [ PBXInput"None D %%% 

if %%% t PBXOut put^SeparateWindow | %%% 

It mi PBXKeyKquivalent-1%%% 

# %%%iPHXArgument=l%1t% 

# %%%lPBXlnc rementalDisplay^YKS )%%% 

If 

it - Custom User Script Tnfu 

il \ USRDir-90StiitipIe Menu Scripts )X1% 

jf %U|t]SRNamo»01 linecount. sh lm 

// 

# counL the number ©f lines in the source file 
CWT w SRC=*m t FBXFilePath IMV 

CNT_L1N1!S=* vc '1 SCKT_3RC" 

it parse out the count value 

CTfT_LBIBS= ’ echo $CNT_LINKS | avk *1 print Si T' 

# display the count results 
CNT_HESSAGE="Nu]nber of lines: $CtiT LIKES" 
echo *$CNT_KESSAGE" 

Search for a selected word or phrase 


'lhe script shown in Listing 2 Ls a little more sophisticated. It 
first stores the selected text into the 3RCH_DAT variable using the 
cat tool. Notice the dash right after the tool. Tills tells cat to 
receive its input dam from stdin. 

The script first retrieves die file path to the active source file. It 
then determines the tile path to the search,output file, and 
stores it into the SRCH_0UT variable. Next, the script passes Lite 
active source file to the nl tool lo renumber the source lines. 
Afterward, it uses grep to parse out tiiose lines dial contain the 
SRCH.DAT pattern, and stores the results into the 
search * output file. 

Tills script also demonstrates how to use Xcode to display the 
search results. It first converts the file path stored in SRCH_QUT to 
a form usable by AppleScript. It then sends a number of 
AppleScript calls to the os as crip t tool. The tool then uses these 
calls to coerce Xaxle into opening the search, output file. 

Listing 2, Searching for a selected text 
(selectSearch.sh). 

* — PR User Script Info — 

* %%%{PBXName=5earch selected text}%%% 

* %%%jPBXtnpiit=Sclection)%%% 

* %%% { PBXOutmit=Discard) %%% 

* %%% (PBXKcy Equivalent=)%%% 

0 %%%[PBXAigumem=l%%% 

* %%% { PBXIncremeotaIDi5play=YESl %%% 

* 

# — Custom User Script Info — 

# %%%{USRDir^yO-SampIc Menu Scrip[.s}&%% 

# %%%{USRName=02-sdecLSearch.shI%«% 

# 

0 retrieve the search parametre 


5RCH_DAT='cat 

* renumber the search document 
SRCH^tNP-"mfFMfileFathSXU H 

^prepare the output file 

SRCH_DlR“’pvd k 

SRCH OUT“*$SRCH_DIR/fiearc’h< output" 

if f -f $SRCH QUT ] ; 

then 

rm -f $SRCH_OUT 
fi 

^perform the search and save the output to the file 

nl ‘b a $SRCH INP | grep "SSRCOAT" I> SSRCfLOUT 

//display the results of the search 
SRCH 011?“"OS X*'echo $SKCH_GUr 
SRCH_0LTT= v eeho $ f SRCH„GUT//\//: f 
SRCU_0UT“"\" $SRCB_Qtm * 

osascript «‘APPLESCRIPT 
tell application "Finder" 

set fileref to get Tile $SRCH_0tlT as string 

tell application "XCode* 
activate 

open file fileref 
end tell 
end tell 
APPLESCRIPT 


Backing up an Xcode project 


Listing 3 shows how a menu script can create a backup of 
the current Xcode project. It also demonstrates how the script 
uses a utility script to interact with the Xcode user. 

First, the script navigates from the current working directory 
until it reaches the level where it finds the first . xcodeproj bundle. 
Tills Is done in ease the active source file liappens to lx? stored 
inside a sulxJinxiory within the project directory. Next, the stripe 
uses the AskUserForNewFileDialog utility script to prompt the 
user for a lockup name and destination. It tlien stores the result into 
the PRJ_BCK variable. 

Now the script uses ilie expr Lcx>l to check die contents of die 
PRJ_BCK variable. If the user cancels die dialog prompt, the 
variable will contain a null string, and the rest of die script is not 
executed. Otherwise, that variable will likely have a valid file path. 
The script then uses die tar tool to archive and compress the 
Xaxie, and stores the backup archive onto die sjxxnficd destination. 

Listing 3* Backing up the active project 
(projBackup,sIi). 


* — Pti User Script Info — 

* %%%\ PBXName=Backup the Xcode projcci)%%% 

* m%{PBXlnpu!^None)%%% 

* %%%lPBXOumut^ScparateWmdow}%%% 

* %%%{PBXKeytquivaleot -)%%% 

* %^%(PBXArg*mienM%%% 

* %%%{ PBXInamentail)isplay=YES}%%% 

* 

* — Custom user script into 

* %%%{USRDif^90-Saniplc Menu Scripts}%%% 

* %%%{USRName=03-projBackup,shI%%% 

0 

* initialise the following shell variable 
PR)_MS<f=''Save the backup as" 

* navigate to the project directory 

PRJ^CHK^'ls -d '.xcodeproj | wc V 
while i $PRJ CHK It 1 1; 
do 

cd ,. 
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PRJ_CHK=’Is d * .xcodeproj | wc -1' 

done 

* retrieve the current directory 

PRJJ>lR- 4 .pwT 

* generate j date/time lag 

FRJ. TAG*'date "HIMS'" 

PRJ NGM^™Ba c kup_$ FK J JTA G * 

* select a backup filename 

PR J_RCK=' VL\ 1 PEXfitilitySeriptsPath I XU/AskfiserPotNevF 11 eDialog V 
“$FRJ_HSG M “$PRJ_NOrt“‘ 

* was it successful? 

PRJ_CJtK- expr W $PRJJBCK" : ■,*" 

if [ $PRJ_CHK -gt 0 ]; 
then 

PRJ_BCK- W $PPJ BCK.tar.gz* 

# start the backup 
tar -czf $PRJ_ttCK '/ 

^ the backup is done 
echo “Backup created at: $FRJ_RCK" 
ft 


Exporting a CVS project archive 

'I Tie script shown in Listing 4 demaastrates how to use CVS to 
export the finest copy of die Xcode project from the project archive, 
li also shows how to use the osascript Ux>l to provide a 
workaround for the AskUserForStringDialog utility' script 
First, the scrips checks to see if the project is currently Ix4ng 
managed by CVS, It does this by looking for a CVS sulxlircctoiy 
within the project itself. If the subdirectory does not exist, the script 
displays the appropriate dialog message. 

If the project is Ixring managed by CVS, the script retrieves 
the path to the project archive from the Root file. It then uses 
the osascript tool to invoke the display dialog function 
with AppleScript. This dialog prompts the user for an export lag, 
offering a timestamp as the default tag. The results of die dialog 
are then stored into the CVS_TAG variable. 

Next, the script uses the evs tag command to apply the tag 
lo the Xcode project. It then retrieves the projects archive name 
from the Repository file. Afterward, the scrijx prompts the user 
for an export name and destination using the 
AskUserForNewFileDialog utility script. It stores the result of 
that interaction into the CVS_XPT variable. 

Finally, the script uses die evs export command to export a 
copy of die Xcode project from die archive and onio die desired 
destination. If it is successful, the script displays a dialog showing the 
directory path of the exported project 

Listing 4. Exporting from CVS 

(cvsExport.s h). 

* — re User Script Info — 

* %%%[P6XNamc=Expon (VS Xcode project)%%% 

* %%%{ PBXInput-Noncl%%% 

* %%% j PnXOutput=ScparatcWindow}%%% 

* %%%{ HUXKeyKquiv:ilcn !=(%%% 

* %%%{I , BXAigunnmt=}%%% 

* %%% [FBXincimenUuDispiaysY ES1%%% 

* 

# — Custom User Script Info — 

* %%%{tTSRDir=9frSamplc Menu Scripts]%%% 

* %%%flISRName=04-cvsExport.sh)%96% 

# 

* check for the following subdirectory 
CVS„DIR^'pwd" 

CVS DlR = ’'$CVS_fiIR/CVS'' 


if t d SCVSJ1TR 1; 
then 

- retrieve the CVS repository path 
CVS_ROQT-'cat $CVS_0IR/Roor 

* prompt the user lor an export tag 

CVSJTAG= date *4WWK%S"’ 

CVS_TAC="osascrl pt «- APPLESCRIPT 
tell application “Xcode" 
activate 

display dialog *Enter a CVS export tagi* ^ 
default answer $ICVS_TAG1 
return [text returned of result) as string 
end tell 
APPLESCRIPT 

# was it successful? 

CVS_CHK=’expr *$CVS_TAG M : 4 .* h ' 

if I $CVS_CHK -gt 0 ]; 

then 

* apply the tag to the sources 

CV5_TAG~“v$CVS TAG 4 * 
evs Q tag $CTS_TAG 

* prompt the user fur an export directory 

CVS_MSG-“Export the project to:" 

CV$jK)M- cat $CVS_DIR/Repository v 
CVS XJ?T=" $CVS_NOH$CVS_TAC" 

CVS_Xt l 'r'%lX]PBXIJtnityScriptsPath)m/AskUserForNowFlleI3ialog 
*$CVSJtSG* *$CVS_XPT M ' 

* was it successful? 

CVS_CRK=expr "SCVSJfPT* : 
if [ $CVS.CHK gt 0 J: 
then 

ft export the CVS project 
evs -d $CVS ROOT -Q export -R -r $CVS_TAG \ 
d SCVS„XPT $€VS NOW 

echo “Project has been exported to: $CVS_XPT" 
fi 
fi 
else 

echo "This project is currently not under 3GH by CVS.“ 
fi 


Concluding Remarks 


Menu scripts arc a flexible and effective way to customize and 
enhance rhe Xcode environment. Their support for standard shell 
scripting languages makes them easy to learn and implement. They 
can add features that are essential to the workflow, but are not 
available in Xcode. They can automate certain tasks that are 
otherwise repetitive and prone to mistakes. They can also invoke 
external Risks without the need to exil the Xcode environment. 

Without a doubt, menu scripts are one of the reasons why 
Xccxle continues to lx: tlie preferred development tail for MacOS X. 
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Let Phlink take the call. Personalized greetings, voicemail, notifications, and much more. 
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The R statistics package 


What is R and how you can use it. 



y 


By Mihalis Tsoukalos 


Introduction 

The R language of statistical computing is a free implementation 
of the S language, also used for statistical computing. Rick Becker, 
John Chambers and Allan Wilks developed S at die famous AT&T 
Belt Lahs, The commercial version of S Ls called S-PLUS and the 
problem with S-PLUS is tliat it Ls very expensive. 

Version LOO of R was first released on February 2000 and 
the latest version of R, at the time of writing UiLs article, is 2.4.0, 
Version 2.3 1 is used for the purposes of this article. 

R and S-PLUS can be used tor statistical analysis and 
graphics. Put simply, you insert datasets that you want to 
analyze and visualize in creative ways. 

What, a statistics package in 
MacTech? 

Well, you may wonder what is a statistics package doing in 
MacTech so 1 think that I have to explain some things to you. 
First, lei me re 11 you dial statistics are nor that difficult in all of 
their aspects —you can use a small division of statistics that are 
incredibly simple. Second, I should add dial statistics can be very 
useful for systems administration purposes including Mac OS X, 
Last, you should know that statistics are particularly useful when 
you want to generate a report for your boss that usually does not 
understand technical information very well. 

If yoti still fed uncomfortable with statistics, please have in 
mind that diis article is not going to use higher-level statistics. 
What will be used are straightforward statistical methods and 
some R commands that generate a lot of handy and impressive 
graphical images. 


Introducing R 


The good news is that there is a Macintosh version of R that 
can either run as a console or a graphical application, R can also 
ntn on Windows as well as other UNIX machines. 

Figure 1 shows the console version of R whereas figure 2 
shows die graphical version of R. In order to run the console 
version you just have to type R provided that the directory of the 
It command is included in your PATH variable. 

WeW— irrtMukjf mon^*tery,kK4l /U»n/mtsoiJk — R - 80*24 

Last login: Thu Nov 9 19:43:16 on console B 

Welcome to Darwin! 

monastery:- Htsoukt It 

R : Copyright 2006, The ft Foundation for Statistical Computing 
Version 2.1.1 
ISBN 3-9600S1-07-0 

R is free software and cones with ABSOLUTELY NO WARRANTY. 

You are welcome to redistribute it under certain conditions. 

Type ’licensee)' or ’licenceO' for distribution details. 

Natural language support but ruining in an English locale 

R is a collaborative project with many contributors. 

Type 'contributors^}" for wore information and 
'atatlorKL on how to cite R or R packages in publications. 

Type dsmoO' for some demos, 'helpO' fot on-line help, or 
'help.startO' for an HTML browser interface to help. 

Type qQ' to quit tf, 


Figure ]: Running R from the console 


As you can see both versions of R have a similar text 
window that you enter your commands. Nevertheless, the GUI 
version is more elegant and offers more options. By typing qO 
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/ Susbsription service now available, running on 

N6tT03 m Mac OS X Server. 

Details at: www.netteamserver.com/subscribe 

SERVER 


Connect your people, contacts, relationships, projects, tasks, documents, 
blogs, web content... your knowledge itself ... and magic follows. 


Most businesses already have this data but in different systems, used by different people, in different 
departments. What a nuisance! NetTeam Server brings it all together, in a web app that everyone can 
use, anywhere. What a difference! 


NetTeam Server 


Features 


NetTeam Server is a business process, content management, collaboration 
and social networking web app for businesses and organizations of any 
size. It offers people, project, task and document management services 
and has a powerful API to support customization. 

The triangle represents NetTeam Server’s unique combination of 
functionality for three critical areas: Process, Content and Community. 


NetTeam Server's fundamental constructs are 
People, Projects, Tasks and Documents. 

These four are central to all business activities, so we 
bring them together in a coherent workspace that 
makes NetTeam Server a true Business Operating 
System. The portal interface can be tailored to match 
client branding and linked systems, and includes five 
Editors (see screenshot) and a modern, AJAX-enhanced, 
configurable user interface. 


We're a good choice even if you only need one of these, but if your 
business operations embrace two or three, you’ll love what we can 
do for you. 



User roles determine access privileges and which (if any) 
tools are presented on login. Blogs are used extensively 
to support publishing, information and knowledge 
management. Wikis will be available in a late- 
summer update. 




NetTeam Server is available for Mac OS X Server, Linux and 
Windows platforms and supports alt leading web browsers. 
A Web Services API allows tight integration with other 
systems and single sign-on. We also offer a Java mobile 
client which can be tailored to support mobile workforce 
applications. 


NetTeam Server has been successful in deployments 
serving from tO to 10,000 users and may be installed on a 
server of your clioosing, used on a dedicated server we 
provide, or rented as a subscription service (multi- 
company server). 


Consultant, reseller and developer enquiries welcome. 


- Web Content/Site Management 

- Web Document Library 

- Project and Shared Blogs 

- News Editor 


- Users, roles and relationships 
• Simple CRM 

- Social Networking 

- Profile & Personal Blogs 















—this works for Ixrth versions— you can quil R. Additionally, 
you can quil the Gill version from its usual Mac-related menus. 
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R : Copyright 2W4, The R Foundation for Matvstitfll LeupuLina 
Version 2.1.1 C2R*6-«6-«l> 

1SBH 3-900*51 -W 0 


R is Free softcore and cwhi wnth A*S©t.UTft.Y HO WARRANTY. 

You one welcome to redistribute it under certain conditions. 
Type 1 lieensef>" or MicancaO' 1 for distribution details. 

Natural language support hut running in on English locale 

R is a collaborative project »ith eany contributors. 

Type "contributorsO' For nare infomaLion and 
"citatienCV on ha* to cite R or R packages m publications. 

Type ^deemC) 4 For sene dcaos, "helpQ* For on-line Help, or 
'help,start()‘ For on HTML browser interface to help. 

Type 'nO* to guit R. 


Figure 2: The R GUI 

R can also be used as a simple calculator. The following 
examples illustrate il; 

>115 

m e 

> abs(-1.4) 

m \A 

R can also be used in a hatch mode —only the command 
line version of it— where you store the desired commands in a 
file and execute them from the command line or a cron job. The 
folk swing commands demonstrate it: 

$ cal example.R 
1 + 1 ; 

5 - 8; 

$ R CKD BATCH example,* 

S cat example,Rout 

R i Copyrighi 2006. The R Foundation for Statistical 
Computing 

Version 2.3.1 (2006-06-01) 

ISBN 3 9000S1-07-0 

R is fret 1 software and comes with ABSOLUTELY NO WARRANTY, 

You ate welcome Lo redistribute it under certain conditions. 
Type ‘licensed' or ‘licenceO* for distribution details. 

Natural language support but running in an English locale 

E is a collaborative project with many contributors. 

Type 'contributors() 1 for more information and 
■ citation!)* on how ro cite R or R packages In publications. 

Type ‘demoO T for some demos, 'help()‘ for online help, or 
' he Ip. start {) ‘ for an HTML browser interface to help. 

Type ‘q0‘ to quit R, 

[Previously saved workspace restored] 

> invisible loot ions (echo ■ TRITE)) 

>1 + 1 ; 

HI 2 


>5 H: 

HI 3 

> 

> proc.timeO 

[lj 0,834 0.169 0.818 0.000 0.000 

> 

$ 


As you can see, the output for the example, R hatch file is 
stored in a file called example.Rout. If the hatch executed 
commands generate any graphics files, Lhtxse graphics files 
should have been created as well. 

Learning more about R and 
Statistics 

One of the most important things lhaL you have to learn is 
how lo insert external data inside R. This can be made using the 
tvad.tahleO command The following example shows how to 
use it: 

$ cat TEST.data 
Name Salary Age 
Mike 100000 25 

Eugenia 200000 22 

John 125000 26 

FIK 250000 38 

Antonis 180000 10 

$ R 

> SAL <- read,tablet“TEST.data - , header=TRUE) 

> SAL 

Name Salary Age 

1 Mike 100000 25 

2 Eugenia 200000 22 

3 John 125000 26 

4 PIK 250000 18 

5 Antonis 180000 30 

> 

In this example, a table was saved in a text file called 
TEST data and loaded into R, Notice the header=TRUE parameter 
that tells that the first line of the TESTdata file is the header row 
of the table and therefore should ixj treated in a different way. 
Also notice that the SAL variable holds the whole table. 

Imagine that you want to learn some information about 
your SAL data. The summaryQ command can be used as 
follows: 


> summary(SAL) 

Name Salary Age 


Antonis:1 

Mtn * 

:100000 

Min. 

: 22,0 

Eugenia.: 1 

1st Qu. 

:125000 

1st Qu, 

:2 r i.O 

John :1 

Med if )n 

:180000 

Medina 

: 26,0 

Hike : I 

Mean 

:171000 

Mean 

:28,2 

PIK : 1 

3rd Qu. 

;200000 

3rd Qu. 

;30.0 


Max. 

:250000 

Max, 

; 38.0 


> 

As you will understand, [his is a great way to summarize 
your data. Now, let tis explain the output, 

The Name column does not contain numbers so R sums the 
occurrences (considering each value as a siring) of each “string" 
and prints the top numbers. As far as Salary and Age columns 
are concerned, which are lx>th numeric, R calculates and 
displays the following six values: 
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Your G5's Dream Date 




The 3 ware Sidecar & Your Apple Power Mac G5: The Perfect Match 


The 3ware* Sidecar by AMCC is a powerful SATA RAID desktop storage solution designed specifically for the Apple* Power Mac* G5. 
At speeds 4-8x faster* than Firewire or USB, it can store and protect tons of your photos, songs, videos, illustrations and web pages. 


Whether youYe editing and archiving digital photo shoots or snapshots, home movies or future 
Academy Award* winning films, garage jam sessions or professional mixes — rest assured your 
data will always be protected. The 3ware Sidecar is designed for creative profess ion afs and 
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- Min.: This is the minimum value of the whole data set. 

- Median: It is an dement that divides the data set into lwu 
subsets (left, and right subseLs) with the same number of 
elements, If the data set has an odd number of dements, then 
the Median is pan of the data set. If the data set has an even 
number of elements, then the Median is the mean value of ilie 
two center elements of the data set, 

- 1st Qu.: The 1st Quartile (ql) is a value, that does not 
necessarily belong to the data set, with the property that at most 
25% of the data set values are smaller than ql and at most 75% 
of the data set values are bigger rhan ql. Simplistically, you can 
consider iL as the Median value of the left half subset of die 
Milled data set. 

In the case that the number of elements of the data set Is 
such that ql does not belong to the data set, it is prtxJuced by 
interpolating the two values at the left (v) and die right fw) of 
its position to the soiled data set as: 

ql - 0,75 * v + 0.25 * v 

- Mean: This is the mean value of the data set < die sum of 
all values divided by the number of the items in the data set). 

- 3rd Qu.; The 3rd Quartile (q3) is a value, not necessarily 
belonging to the data set, with the properly that at most 75% of the 
data sen values are smaller than q3 and at most 25% of the data set 
values are bigger than q3- Put simply, you can consider the 3rd 
Quartile as the Median of the right half subset of the sorted data .set. 

In the case that the number of elements of the data set is 
such that q3 does not belong to the data set, it is produced by 
interpolation of the two values at the left (v) and the right (w) 
of its position to the sorted data set as: 

q3 “ 0.25 * v + 0,75 * w 

- Max.: This is the maximum value found in the data set. 

Please note that there exist many practices for finding 
Quartiles, In you try another statistical package, you may get 
slightly different results. 

Creating Graphics with R 

In the main pan of the article I am going to tell you how to 
generate creative graphics with R, R has amazing graphical 
capabilities. Please luok at the Bibliography and References 
section for more information. Also, the presented examples are 
real examples, using real data. 

WWW server example 

For this example, 1 used some old web server log data from 
a real web server The duration of the logs is one week. Let me 
explain all the required steps. 

First, let me show you some things about the log files using 
die wc command: 


$ wc -.log 

416041 6656584 119534/21 dayl.lag 
429039 6864552 123800090 day2.log 
1185958 18975185 338653060 day3.log 
1162803 186047/6 330550972 day4.log 
1157444 18519068 329710792 day5.log 
1209289 19343537 342242234 day6.log 
1078902 17262326 30/343799 day7.log 
6639476 106231028 1891835668 total 


The wc command provides us counts of lines, words and 
bytes of each file. As you can see, the web log files are big as 
this is a very popular web server. 

Tiie log hie format is the “standard" Apache "combined" 
format as follows: 

Melds; date time c- ip cs-username a ip efl-raethod cs-uri 
stem es-uriquery sc status sc-bytes cs bytes time-taken cs 
version cs(User-Agent) cs(Cookie) cstReferei) 


T have now to decide which fields to use and extract from 
the log files. I will use the following fields: 


time: the time of the request 

sc-bytes: a number that shows the server to client bytes 
cs-bytes: a number that shows the client to server bytes 
time-taken: the time —in milliseconds— it took the 
web server to process the request. Please note that a 0 value 
may declare that the requested resource was stored in a 
cache memory and therefore the web server did noL have to 
process it. 


The following UNIX shell script does what we want: 

S cat WWW.sh 
#[/bin/bash 

grep v * A JT dayl.log | awk Mprint $2, $10, $U. $12)* | 
sed 's/;/ /g* j awk '[print $1 $2, $4 t $5, $6)* 


Its output, for the day I .log file, begins as follows: 

00:00 137 465 0 
00:00 142 471 0 
00:00 13449 338 Q 
00:00 140 471 0 
00:00 142 476 0 
00:00 141 468 15 
00:00 142 474 0 
00:00 466 228 0 
00:00 139 465 U 
00:00 140 464 0 

Of course, you have lo change the day U log string to fit your 
own filename. 1 did so for the rest of the web server log files. 
The files created are as follows (again using the output of the 
handy wc command): 

$ vc ', data 

416033 1664132 6816604 day 1,data 
429031 1716 124 7026785 day2.clata 
1185942 4/43768 19385103 day3.<3ata 
l162795 4631180 19041770 day4.data 
1157440 4629760 18933110 day5.data 
1209281 4837124 19748074 dayfc.data 
1078894 4315576 1/627914 day?,data 
6639416 26557664 108579360 total 
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If you want to hive header data in your files, you ('an do it 
by manually editing the output files. 1 pur the Time sc cs 
timeTaken* line at the beginning of each of the daily data files, 
Now t we are 1 finally ready to use R to process some of our 
data. 1 used the Misc ® Change Working Directory (or 
Command-D) option to change my working directory so that I 
will not have to use full paths for my data files. 

First, I am going to use the mmmaryQ command to 
overview my dayl data, 

> dayt < read.table("dayl.data", header“TRUE) 

> summary(dayl) 

Time sc ns 

limeTaken 


18:05 

; 775 

0.0 

Kin, 

0 

Kin. 

: 0.0 

Min. 

17:32 
Qu.: 

: 708 

0.0 

1st Qu. 

141 

1st Qu, 

: 378.0 

Iflt 

12:21 

: 697 

0.0 

Median 

142 

Median 

: 431.0 

Median 

17:0/ : 696 

: 253.3 

Mean 

2997 

Mean 

: 428.9 

Mean 

10:15 

Qu.: 

i 693 

0.0 

3rd Qu, 

842 

3rd Qu. 

: 464,0 

3rd 

18:13 

: 68/ 

Max. 

5686096 

Max. 

:2340.0 

Max, 


:1908734.0 
(Other) i 411 /77 

> 


You can easily see the moments that were very busy: 18:05, 
17:32, 12:21 p 17:07, 10:15 and 18.15. You can also understand 
from the timeTaken column output Lhat your web server was 
serving requests pretty fast (because the 3rd Qu. value is 0). 

There is also a very quick way to represent a data set 
graphically. It can be done with the pairs(<datasetjname>) 
command which plots pairs of the columns in a data set. The 
output of the 

> pairs(dayl) 

can be seen in figure 3, Isn't it worth every statistical definition 
you have read in this article? 
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Figure 3: The output of the pairs (dayl) command 
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The attacbQ command takes a data set as its argument, 
and lets you use the columns of the data set separately, in this 
example, I will use the day2 data. Also, check the objecLsQ and 
seardjQ commands that help you discover existing objects. 

> day2 <- read.table(“day?.data", header=TRLJE) 

> attach(day2) 

> objects0 
[1] “day2" 

> searchQ 

111 ".ClobalEmT - day2 H "u>oIs:IlGlir 

[4] "packagemethoda" "package:stats" 

"package:graphics- 

171 "package;grDevices" “package:utils" 

“package:datasets H 

t10] “Autoloads" "package:base" 

> objects(2) 

[ 11 "Time" "cs" "sc" "titseTaken" 

> 


The plot(Time) command wall produce figure 4. This figure 
si tows the total number of connections per lime. It makes sense 
that after midnight there are less connections than the rest of the 
day. On the other hand, unreasonable outputs may be the cause 
of a network attack. 



Figure 4: The output of the plot{Time) command 

Last, imagine that you want to limit the output values for 
both x and y variables. You can do that by using the xlim and 
ylim parameters of the plot command. The following example 
shows this (the output can be seen in figure 5): 

> plot(cs. sc* alinrc(450, 500}, ylim=c(450,500J) 

Network data example 

In this example, I will use network data, As many of you 
already know, the usual way to capture network data is the 
tepdump tool. The output of the tqxiump utility is difficult to 
read but there are many tools (i.e. tepshow, ethereal/wireshark) 
that will help you parse it. Anyway, imagine that you have 
readable tepdump output that contains the following fields; 



Figure 5: Limiting the values of the output 

Packet Number: column title Tackef 
Time: column title Time” 

Time Difference front Previous Packet: column title “dr 
Source Port: column title M sp" 

Destination Port: column tide “dp n 

I used the Lcpshow package which produces output that 
looks as follows; 


Packet 171 

TIME: 15:00:15.367167 (0.000100) 

LINK: 00:60;97:DE:S4:36 -> 00:00:00:04:41 :BC type“IP 

TP: 207.46.130.119 -> 172.16.117.52 )tlen-20 TOS=00 

dgramlen=40 id—003A 

MF/DF-0/1 fraj-0 TTL-64 proto=TCP cksum-C797 
TCP: port http •> 1024 sey=l274940415 ack=3I8390083I 

hlen-20 (data=0) UAPRSF=010000 tmd-32735 eksuo=2A2F urg=0 
DATA: <No dnta> 


Packet 172 

TIME: 15:00:15.455012 (0.087645) 

LINK: 00:00:00:04:41:8C -> 00:00:4F:A3:58:23 type-IP 

IP: 172.16.112.20 > 192.168.1.10 hlen=20 TOS-OO 

dgramlen-60 id-0060 

HF/DF-O/O frag“0 TTL=63 pcoto-UDP cksun-9C5A 
UDP: port domain -> domain hdr“8 data=32 

DATA: .9. 

hostmaster.com. 


I used a small Perl script to extract the data (TCP traffic 
only) that l wanted from the tepshow command output. 
Remember that you may have to replace text values like http, 
telnet, etc., found in tepshow output with their service numbers 
so that R can use it. 

'Iliis time, l will also bring into play a new K package for 
creating graphics called lattice. The following command shows 
how to load the lattice package in R. 

> library(lattice) 

In order to get some help afxRit the lattice package, you can 
type the following command: 

> help(lattice) 
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Alter executing the last command inside the graphical 
version of R, you will get the output shown in figure 6. 
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Figure 6: help(lattice) graphical output 

For the first example, l will use ihe dam from the first three 
cu lumas f Packet Time, and di) of the extracted data (C3-data 
file), I executed the following three commands: 


> c3 <- read.table£*C3.data*. header=TRUE) 

> attach(eT) 

> c3m <. a£.»atrix(read.table(“C3.data". heartsr^TEUE)) 


You already know the first command. The second 
command inserts the data as a matrix (as.matrixQ command) 
because some graphics functions that plot more than two 
variables will only accept data as a matrix. Do not forget to also 
mn the library (lattice) command. 

Write the following commands in a text editor. After that, copy 
them and paste them inside R, You wall get figure 7! Tills example 
is based on an existing example that uses the volcano data set. 

x <- 10* (I : tirawte Jm) J 
y < IQ"(1 :uco1(c3b)) 

imagelx, y. cJro. col = terrain,colored 100). axes - FALSE) 

contour(x, y, c3ns, add - TRUE, col ^ “peru") 

axisU, at ~ seq(100, 800. by = 100)) 

axis(2 f at “ seq(iGD, 600, by = 100)) 

box () 

M t:3m plot 1 *, font .ttiaiti = 4) 


Do nut ask me about the physical meaning of that graph, 
tf you know your data, you can tell more about this image. This 
is just an example about getting an idea of R capabilities. 

Now, I am going lo show you a more down-to-earth 
example. The following commands 

> plot.newt) 

> xyplot(Packet ~ Time) 

) title (main *■ "Packet vs Time'*, font.main, = 4} 


will plot Packet number versus Time —-using data from the c3 
dataset— as can lx* seen in Figure fi. Straight lines may 
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data-entry... forever. 

You can now synchronize your FileMaker and web 
(SQL) databases. Data is compared on a record- 
by-record as well as peid-by-peld basis. Existing 
databases can be configured for synchronizing 
with just a few modifications. 

Some of the features include: 
f Eliminates double data-entry 
if Two-way synchronizing 

✓ Field level conflict checking and resolution 

✓ Setup Assistant 

1/ Creates all SQL statements for you automatically 
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Figure 7: Plotting the c3m data set 

represent complete HTTP transactions. You can see that there 
are moments that there is not so much TCP traffic whereas other 
times Lite TCP traffic is very high. 


For die last example I will use the data from the last two 
columns (sp, anti dp) of the extracted information (C2.data file). 
First, run the following commands: 

> c2 < read, tab lef*C2. data "T headerKTRtlE) 

> attach(c2) 

> c2m <- ae.matrix(read♦tab1 1 + ( M C2,data", header^TRUK)) 

> summary(c2) 

sp dp 

http :2472 http :1923 
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smtp i 

202 

smtp 

: 223 

telnet : 

39 

telnet : 

42 

1024 : 

31 

1024 

: 38 

2615 ! 

22 

1306 

: 36 

1026 : 

21 

4233 

: 27 

(Other):2124 

(Other):2622 


As you can easily understand, the summary command is 
very useful and meaningful this time. This traffic lias many 
HTTP, SMPT and TELNET requests. If you are concerned about 
security, you may try to lower the TELNET connections and 
replace them with secure connections ( ssb ). 


$ vc -1 hour* 

25647 hourl 
23211 hour2 
70192 hour3 
67904 hour 4 
59699 hour5 
60121 hours 
58629 hour? 

365403 total 

$ vc -1 hour* > hourl3.data 
$ head -n 7 hourl3,data > hour13 

Now, let us go hack to R and execute the following 
commands: 


As this sample contains non-numeric values, there are not 
so many things to do. I 1 lolling your data set is something you 
can do (figure 9): 

> plot(c2j 

> title(main “ “dp vs sp plot", font.ratfin - 4) 


> hours <- read*table("hour13“) 

> attach(hour) 

> barplot(VI* angle=c(45,1 35), density^!!)* eol^grey". 
names^cf"Sunday", “Monday". “Tuesday". “Wednesday". 
“Thursday", "Friday". “Saturday") ) 

> titleEttiain=*Web server connections from 13:00 to 13:59". 
font=5) 




iJHWtil- 


The output can lie see in Figure 10* 


a 


Figure 9: dp vs $p plot 



One more thing 

You may wonder by now why did I talk about web log files 
for seven days although I used only two of them! Well, the 
answer is that I am going to use them now. 

Run the following commands for each one of the seven 
web log data files: 

head n 1 day1.data > hour! 
gtep “ A 13: “ day1.data » hourl 

Tilts will create seven files, each of them containing the weh 
log data between 13:00 and 13:59, one for each weekday. Also, 
execute the following command: 


***** Hi - 



Figure 10: A bar plot 

Tills procedure can be easily automated (and also run 
using cron) and therefore you can have a report of your data 
every day at your email account! 

What else can R do? 

Now that you have learned more things about R P let me 
briefly tell you what else can R do. Well, R can also perform 
the following: 

1* Advanced data analysis. 

2* Advanced statistics. 
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3, R lias an object oriented programming language that 
you can write your own programs. 

Summary 

In this article you learned a lot — you learned some 
basic things about R, how to import data into R, and how 
to create graphics with K. 

Those things can Jkj very valuable for regular users 
and, especially, for system administrators. 

Conclusions 

l hope that this article did not contain loo much 
statistics. J also hope that you have, by now, understood 
some of the capabilities of R. If you want to learn more 
about R then visit its home page, and check out some of 
tile proposed books* 

The output of R should help you prove your points to 
either your colleagues or your manager and get a general 
overview of your data. 

Please let me know if you have any questions or if 
you want another article about R and its rich graphical 
capabilities. 
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Kevin Tureski— Director of Engineering, Maya, Alias Systems 
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Introduction 

Like any gtxxi developer or |X)wer-user, you've been using 
the great tools that come with Mac OS X to automate much of 
your workflow. Applescript and Automaior together allow you 
to rid yourself of repetitive tasks. You import, backup, convert, 
and markup your photos automatically. Data backups happen 
once per week, wit!) incremental backups in between. 

1 lowever, despite all this effort to make your computer work 
more efficient, safe, and hassle free you probably haven’t really 
considered how much your Mac could lie doing for you. Why restrict 
your automation to just the virtual desktop, why nol also automate 
your rva! desk. While you’re at it automate your office, house, store, 
garage, shop, or any Other place where you have a Mad 

Seem a little too Sci-Fi? Just imagine that in the morning your 
alarm goes off. As you get out of bed your coffee maker I logins 
brewing a fresh pot of coffee, your Mac wakes up, starts 
downloading your email, updates your news RSS feeds, opens 
iCal to the day’s agenda, and plays some soothing morning music. 
! lalf-an-hour later y<mr coffee maker automatically shuts off As 
you pull out of your driveway your computer performs a backup 
of your files then goes to sleep* When you come home at night, 
your house knows that it’s dark outside and turns on the porch 
and hallway lights for you. When you’re ready to watch a movie 
you [util up FrontRow and 
the living room lights dim, 
the stereo turns on and 
your video starts playing. 

You could do the same 
thing to your shop, office, 
or garage. Save energy by 
turning off unused lights, 
know the state of your 
security system via a web- 
browser from your house, or get notified by email when someone 
enters your driveway. These are just some of the possibilities of 
an automation system powered by your Mac. 


By Andrew Turner 


In tiiis article we will introduce you ro the current held of 
taxation Automation in the Apple world, it’s not just alxiut your 
house anymore. Automation software has become more 
advanced, hardware more prevalent and robust, and the 
community has grown, We will show you how to gel started, 
setup your environment, and connect to the community. In 
future articles, we will cover more in-depth topics such as 
writing complex scripts, web interfaces, homemade sensors, and 
notifications on your cellphone, email, or Skype* 

A Whole World of Options 

There are two main components of the automation system: 
automation devices, and the management software that wifi 
connect to all these devices and allow you to create your scripts 
and settings. 

Hardware 

When home automation became really popular several 
years ago, everywhere you looked there were ads for X-1Q 
devices. More often titan not, the advertised systems were 

camera systems that had little to do with the XI0 standard 

associated with automation 
systems. However, the ads 
made the term X10 known 
to most computer users* 
X10 is a standard 
communication system 
developed in 1975 for 
remote control of devices 
in a home or building. This 
standard is known for 
sometimes being unreliable a*s the communication between the 
controlling computer and the devices is dependent on the 
quality of the wiring in the building. 
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Save energy by turning off unused 
lights, know the state of your security 
system via a web-browser from your 
house, or get notified by email when 
someone enters your driveway." 
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MacForge indexes and tracks open 
source projects that run on the 
Mac, or are likely to without 
modification. Thanks to 
MacForge, there's no need to sift 
through huge listings of open 
source that you can't use. With 
categories, filters, and more, 
MacForge makes it easy to find 
what you need. 


MacForge: 

Your Gateway to Mac Open Source 

www.macforge.net 

Sponsored by MATIECH 


Recently, several more robust standard have begun to 
emerge to address the frustrations and shortcomings of 
X10. Most are still in the standards formulation and beta 
release stage. These include Zigliee, IIPB. WiMax, Z- 
Wave, and HomeRR 

One technology that very has been recently released 
and gained widespread use and support is iNSTEON, 
which was developed by Smart Labs Technology, 
INSTEON couples the traditional powerline 
communications with redundant mesh-networking to 
speed up response times as well as add state verification. 
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'Utilizing a wireless transceiver, you 
can turn control devices or send 
commands to your Mac using key 
fobs and small control pads." 


These techniques are implemented to provide users with 
a hopefully more enjoyable and reliable automation 
system. 

A benefit of the new INSTEON system is that it is 
backwards compatible with the older X10 devices. This 
allows current users to slowly upgrade their existing XI0 
automation systems to INSTEON, and new users purchase 
the newer INSTEON coni roller and then purchase 
INSTEON or inexpensive XH) modules as necessary for 
your location. For this reason, in this article we will design 
our automation system using the INSTEON modules. 
Readers can apply the same techniques to older XI0 
components. 

There are 3 key liardware pieces required for the 
simplest automation system: controller, signalinc 
receivers/repeaters, and a device module. We suggest you 
look at buying starter packages from a vendor (see 
Resources) to star! off your automation system. An 
INSTEON starter package will cost about $130 USD. 

The controller connects to your Mac: via USB and 
plugs into an electrical s<x kei on the other end The 
controller will send and receive signals from the INSTEON 
devices at your location. If you Ye on a budget, you can 
stick with an X10 controller like the FowerLinc U32CU, 
which is USB and therefore doesn't require a USB to Serial 
cable. The FowerLinc also has good support with most of 
the available Mac software packages. 

The StgnaLinc receiver/repeater are new devices that 
provide die INSTEON signal repeating and mesh- 
networking redundancy. The Signalincs come in a pair, 
and plug into wall sockets around your location. They 
also have small antennas and will need to be setup so that 
the pair can communicate wirelessly through your walls. 

The device module can be a lamp dimmer or 
appliance controller (on/off). These modules plug into a 
wall socket, and then you plug the lamp or appliance into 
the module. You can then turn the device on by using the 
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appliance's own power switch, by using your Mac, a 
control pad, or 1NSTEON switch. Additionally, a device 
module can he a sensor such as a motion detector or 
window sensor For a less apparent automation system, 
instead of an external module, you can get a wall socket 
that will replace your current socket. 

Other typical pieces of an automation system are 
switches, button controllers and control pads. These 
devices have the benefit of looking and operating like 
normal wall switches and power controllers while also 
hooking into your an tor nation system. A control pad 
plugs into a wall socket via a cable, or communicates 
wirelessly. U is a good idea to have at least one control 
pad that provides direct control of your hardware 
devices. That way if your Mac is turned ofF, out of 
commission, or you need to debug your home 
automation system, you can use the control pad. 

In addition to the basic devices discussed above, it is 
possible to tie in a HVAC (heating ventilation and air 
conditioning) controller, security systems, sprinklers, 
house sensors, theater systems, and cameras. 

For wireless interface, it is possible to get a 
wireless transceiver. Utilizing a wireless transceiver, 
you can turn control devices or send commands to 
your Mac using key fobs and small control pads. 
Additionally, the wireless interface will detect 
commands from motion detectors and magnetic 
switches like the DS10A, and they will show up like 
XI0 devices. 


The W800-RF32 is a well-supported wireless interlace 
that plugs into your Mac. Because the W800 is a serial 
device, you will need a Serial-to-USB converter. The 
Keys pan adapter is an affordable and very well supported 
option. Using the W80Q you can receive signals from 
wireless door sensors, or wireless remotes inside and 
around a house or office. 

Look at an online automation vendor for other device 
options. Also, X10 has lieen sold under a variety of other 
branding labels, and these devices are often found 
inexpensively online or local stores. In particular, the 
Black & Decker Free wire system provides outdoor X10 
plugs, and a wireless remote interface that is great for 
controlling holiday lights or other external devices. Radio 
Shack also carries home automation devices that work 
with X10, and therefore INSTEON systems as well. This 
can he a great place to quickly pick up devices rather 
than waiting for that box in the mail 

Software 

Once you have your hardware in hand, you will need 
a way to control and read all your devices. Automation 
software runs on your Mac computer and allows you to 
setup triggers, groups, and scripts to give some 
intelligence to your automation system. Without a 
software controller you are limited to simple control of 
devices and small groups of devices. 

There are currently 5 software options on the Mac: 
Perceptive Automations Indigo, Sand Hill Engineering's 
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XTension, AlwaysTtlinking s Thinkingl iome, Findley 
Studios' HomcRmi, and the open-source MisterHousc. 

MisterHouse is an open-source option dial is built on 
Perl. It runs on all the major OS's; MS Windows, Linux, 
and Mac OS X, The scriptability of MisterHouse is very 
powerful, and the entire underlying system is exposed for 
the user to tweak as desired* However, the learning curve 
is somewhat high, and INSTEON support is starting to 
emerge, but not solid yet. 

XTension has long 
been a well supported and 
very reliable Mac 
automation solution. It has 
been developed and 
supported for over 10 
years* and includes many 
interest ing features. f n 
addition to the normal 
configuration and control 
of devices, XTension 
allows users to configure 
their own layouts and 
switches in the client 
views, and the ability for 
multiple XTension 

instances to communicate 
with one another over a 
network. It also offers a 
unique capability to utilize 
multiple controllers, which 
is useful for dealing with 
bridging different jxjwer 
legs in buildings* Lastly, XTension has a large AppleScript 
dictionary lor users to write their own logic, and good 
integration with web cameras* 

The developers of Xtension, Sand Hill, evaluate new 
technologies before necessarily implementing them* 
Their philosophy is that a critical component of the 
automation system is reliability. Therefore, their releases 
and feature updates are less frequent than other 
automation software options. Sand Hill also maintains a 
very extensive list of tutorials and information on 
automation systems and is definitely worth reading for 
learning more about the subject* 

Perceptive Automation's Indigo was upgraded recently 
to a version 2.0 with a large list of new features, including, 
foremost, that it is a Universal Binary, so it will run natively 
on your new Intel-based Mac. Indigo supports XI0 and 
INSTEON controllers* utilizes Client/Server architecture, so 
it's easy to control your automation .system from a remote 
computer running just an Indigo client* For additional remote 
control, there is a very configurable web interlace, and 
Dashboard widget, and very active community and forums 
to help you set it all up* Using the web interface, you can 
quickly control your automation system from anywhere in 


the world (disclaimer: the author developed the web 
interface and widget, and the source code i*s available under 
an open-source license). Indigo is available as an 
unrestricted 30-day demo available at Perceptive 
Automation's website. 

ThinkingHome, and HomeRun all provide adequate 
interface to XI0 controllers, with varying levels of 
scriptability, interface, and overall features. Unfortunately, 

these three options don't 
appear to be actively 
updated, though they're 
still available for trial. 
They’re also only 
available for PPG and not 
as Universal Binaries. 

This was a quick run 
down of the various 
automation software 
solutions available on 
the Mac. Due to the 
active development and 
support of Indigo, as 
well as the ease of use, 
support of Mac 
technologies, and 

impressive list of 
features, we will be 
discussing Tndigo in 
more depth in our next 
article. 

Putting it 
Together: Designing your 
Automation System 

Now that we've covered the different pieces you will 
need to automate your place, lets design a system. For the 
purpo*ses of this example, we will use a small office 
(homes are typically used, so lets Lurn it around). Besides, 
the example could easily l>e inverted and applied to a 
home, workshop, or home office* 

First thing to do is to list the devices you will want to 
control with your automation system. Lets say: coffee 
maker, overhead lights, desk lamp, door and window 
closures* and a stereo system. Additionally* we want to 
integrate the system with our existing switches to keep the 
transition to an automation system transparent to other 
members of the office. Just like SAF (Spouse Approval 
Factor) there is such as thing as Co-worker Approval 
Factor (CAP)* Based on this list, we will need to determine 
our "Bill of Materials" to order from an automation store* 
We will also use this list to record the device addresses of 
our modules for later programming into Indigo. 

Tills is just a suggested system* and you're free to 
choose and configure the devices as you see fit. Our 
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Figure 1: MisterHouse offers a lot of features and configurability, 
but has a steep learning curve 
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Table 1: Components for a Sample Office Automation System ReSOUXCCS 


Component 

Computer Interface 
Coffee Maker 
Overhead light switch (2) 
Desk Lamp 
Stereo 

Doors, windows (6) 

Wi re I ess Lransceive r 


Device 

Power L i n e/S i gi i a l Li n cs 

AppBanceLinc 

Switch Lin e 

liimpLinc 

ApplianceLiac 

Powerflash or DSIOA 

W800-RF32 


example office is just a general example of" a simple system 
that mi I izes die prind pa I pa rts of a n a u tomation system. 

Summary 

We just covered the basic s and options of an automation 
system with your Mac:, The automation software available for 
your Mac allows unlimited customization, and hardware and 
interlaces are plentiful for whatever you want to control or 
sense. In our next article, we will setup an automation system 
for a small office/workshop, setup modes, a web interface, 
and notifications. 


Vendors 

Smart Ho me - http://www.smarthome.com 
FunForGeeks — http://funforgeeks.com 

Software 

Indigo - http://www.percepfFveautomation.com 
XTension - http://www.shed.com/ 

MislerHouse - http://misterhouse.sourceforge.net/ 
Thinking! I ome - http://www.alwaysthinking.com 
HomeRun - http://www.findieystudios.com/homerun 
Resources 

XTension Mailing List 

http://lists.shed.com/mailman/listinfo/ xtensionlist 
Indigo Forums - 

http://www.perceptiveautomation .com/phpBB2/index.php 
comp.home,automati< in - 

http://groups.google.com/group/comp.home.automation 

_Till 

About The Author 

Andrew Turner is an independent software developer and technology 
integrator who has built robotic airships, automated his house, 
designed spacecraft, and in general looks for any excuse to hack 
together cool technology. You can read more about his projects at 
www.higbearthorbit.com. 
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Mac In The Shell 


by Edward Marczak 


On Logs 

Everything you need to 
know about your system ^ 

Introduction 

Log files are the heartbeat of your system. You can track 
what's going on in good times and Irad - the latter hopefully 
pointing you to a way to make things right again. When I say 
'heartbeat 1 , however, I should be dear that it's really many 
hearts. All of the child processes jabbering away, speaking their 
part. Tills article aims to teach you how to read logs, show 
examples, explain the various log contents, and give some 
logging lips and tricks. 

Log in the Shell? 

Now, logs may not lx? a shell topic per se h they’re often 
associated with work in the shell, and perhaps for good reason. 
On an OS X box, you have the excellent Console.app 
(/AppIications/Utilities/Console. app). It gives you quick access 
to most important log files, provides quick searching capabilities, 
and will automatically decompress gzip-rolled logs. Plus, you 
don’t need to open a shell just to access your logs, if that sort of 
thing bugs you. Additionally, on an OS X Server, the Server 
Admin application accesses various logs depending on context 
While Server Admin is useful for a quick peek, it uses an HTTP 
call to pull down the log files at appropriate intervals. Due to 
this, its not a good way to watch a file fill up quickly. This 
brings us back to the shell. 

Longtime readers of this column already know where Vm 
heading with this; we're going to run Terminal.app and be 
looking at logs through a command dine interface. So, open it up 
now t/Appl tea tions/ljti] ities/Te rm i naLapp). 

Log Central 

How do entries in log files appear? This may seem to be 
a simple question, but it isn't. A log is simply a text file. This 
text file runs in chronological order, with new entries 
appended to the end. Any application is certainly capable of 
performing ihis on iLs own, and sometimes, that is the case. 


More commonly, though, log entries will be logged to llie 
syslog daemon, which in turn is responsible for writing the 
entries to the proper log or logs. Interestingly, but perhaps noi 
surprisingly, Apple has their own logging facility intended to 
replace sysiogd. In fact, the little secret here is lhat syslogd is 
the Apple System Log in disguise. 

The Apple System Log, or YtsL is a syslog-compatible 
replacement for standard syslog (which deviously is named 
‘syslogd'). Fortunately for everyone involved, you can still treat 
it just like syslog, which I will tend to do here. 

Programs use an API to write log entries to the syslogd 
server. As the suffix may clue you in to, syslogd runs as a 
daemon in the background. As of 10.4, it’s initially run, and 
subsequently controlled from la undid. Of course, 
applications are free to just drop a text file somewhere and 
write to it. 

Fluency 

Let s take a look at a typical log entry. We'll start out easy; 

Nov 6 06:54:40 Jack-Kerouak lookupd[1775j; lookupd (version 
169,5) starting - Hon Nov 6 06:54:40 2006 

This is, of course, one long line, but you should get used to it. 
Often, log lines will wrap - on paper and in your terminal. Each 
line is read left to right, as you'd expect. 1 jet's pick this entry apart: 

Nov 6 06:54:40 - 'Hie daLe and time that this entry was logged. 
Do note that this is a 24-hour clock (“military lime*). Also, read 
on for a note about GMT entries. 

Jack-Kerouac - The hostname of the system dial logged this 
entry. Jack-Kerouac is the name of my FowerBook as I'm often 
‘On the Road'. 

lookupd[1775] The name and process id or pid that sent the 
message to the log. 

lookupd (version 569.5) starting - Mon Nov 6 06:54:40 
2006 - The message itself. This is a simple, "hey, I’m starting 
up" message. 

Thai was easy, right? The time is an obvious one: you need 
this to figure out the sequence of events, or, correlate log 
events with some other happening ~ be tl electronic or real- 
world (like a power outage, etc.). Why do we need the 
hostname? If we Ye looking at the entry in a log on a 
particular system, it came from that system, right? End of 
story, no? Fortunately, no. syslogd can lx? set up to accept 
log entries from other machines and devices. This can be 
incredibly useful, but only if you know the host that’s 
creating the message! 
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The next entry is the process name and process id that sent 
this message. While the process can set any name it likes, the 
syslog daemon is responsible for logging the ptd that sent the 
message. Having the pid is interesting: some processes are long- 
lived, and you can easily correlate a log entry with a pid Some 
processes are very ephemeral, and will have wisped away 
I before you can hunt them down based on ihdr pid. Also, if 
you're looking at an aged log, don't rely on the pid! Process IDs 
come and go, and may be recycled. Don't look at yesterday's log 
and try to line up events with pids - even from the same 
process. These entries may be hints, but until you have good 
evidence, they should be considered suspect. 

Finally, we have the message, or, what the program is trying 
to tell you! Of course, tills depends on the situation. In my 
example, lookupd Is just letting us know that it is starting up. It's 
simply informational. 

Who’s on First? 

Where does one find logs to watch? On a typical Unix 
system, you'll find all of your logs under one neat hierarchy: 
/var/log. As is typical for Apple, however, you'll Find all of your 
Unixy logs in /var/log as you may expect, Apple-Red logs under 
/Library/Logs, and user space logs in each users ~/U bra ry/Logs 
directory. Wow. That's a lot of logs. 

My example entry above came from /var/log/system Jog. 
system,log is as close to the heartbeat of the system as possible 
with one log. Consider it the log. Of course, that viewpoint 
depends on what you're trying to troubleshoot. That said, 1 do 
like leaving system.log up in my face as much as possible. It's a 
great way to pick out issues Ixdbre they cause havoc 

Which Way Did They Go? 

For apps lhal log through syslog, how does syslog know in 
which logs to write each message? For that, you need to consult 
/etc/syslog.conf. Ibis plain-text configuration Hie for syslog 
Follows some very standard conventions. Lines beginning with a 
hash (**#") are ignored, and don't contribute to the configuration. 
The is a wild-card, and can match multiple facilities. 

Repeating designations and specifying different log files. 

One of my first articles for MacTech detailed syslogd, its 
conventions, how to get it to accept remote messages and how to 
get it to write messages to various log files. It's now on-line at 
hup :i * w ww.mac t c e h.co i\v articles /01 aci ecli/Vu i,20/20.1 21 U n i \ 
Tipb ^rosx him!, One of ihe few things in that article 
that needs updating for 10.4 is how to get syslogd to allow remote 
messages to be logged. We had an article earlier this year that 
details this procedure, so 1 won't go into the detail that he did. 
For the sake of completeness, though, 111 give you the 
walkthrough. Remember: you do not need to do this to follow this 
article. You would typically only do this on a server that is up 
24x7 and will centralize logs for an entire LAN or enterprise. With 
that out of the way: 


1. Edit/System/Uhrary/Lai inch l>ae me >as/amapple.syslogd. plist 

1 Add "-if to ilie PiograjnAigiiments key, miking it kxjk like this: 

< k oy >F ro amAr gmne n t a < / key > 

Carray) 

<strifig>/utfr/sbin/syslogd</string) 
<string>-u</string) 

</array 

3. Save the file 

4. Reload syslogd: 

launcher1 unload 

/System/Library/LaunchDaeraons/com,npple,sysl ogd .plist 
# launchctl load 

/System/Library/LaunchDacmnns/com.apple.syslogd,pi 1st 

5. While that gels it going immediately, something wreaks havoc 
with it during die nightly cron routines. To counteract this, 
simply unload and load syslog each nigbi in a script. Create 
/ete/daily.local and add the following lines: 

launched unload 

/System/Library/LaunchDaemons/cntn.applft.syslogd .plist 
sleep 2 
launched load 

/Systen/Llbraiy/Lai.inichBfleoiions/coiiL.apple.syslogd .plist 

6. Save tills file. 

7. Mark /etc/daily.local executable: 
sudo chmod 744 /etc/daily;local 

8. Now you Ye done! 

Again, this is just the how. For the *why\ please reference 
Aaron’s article. 

Watching the Detectives 

So, how does one watch a log? As alluded to earlier, there 
are several ways. There's the very excellent Console.app. Of 
course, earlier, 1 lusted reasons why 1 prefer the shell for such a 
task, so that's what fl! lie covering. There are three distinct 
programs that let you follow what’s going on with a log file. 

First, there's the ubiquitous tail, tail displays the Iasi 
lines of a file - 10 by default. More importantly, you can use the 
*-f switch to have tail follow the output of a log file in “real- 
time". T put that in quotes simply because there's always a delay 
lxrtween when an app performs an action and posts a log entry, 
to the time when it actually shows up. That said, tail is about 
the best you can do. A listing in print will just not do this justice: 
you need to see it in action yourself So, please, open an admin 
shell, and run: 

tail f /vaE/log/syeteiiw lug 

You’ll initially see the last 10 lines of system log, and then, as 
new entries are posted, the display will add them to the listing. 
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Unfortunately, the OS X version of tail is missing a 
critical feature: following multiple files at once (you can, 
however, simply tail the last line of multiple files). Every 
other version of tail I’ve ever worked with could do this: 
Solaris, GNU/Linux and yes, even FreeBSD 6, Fortunately, if 
you Ye a fink or Mac Ports user (nee Darwin Ports), you can 
install the excellent mul ti tail, multitail makes up for 
the lack of features in the current tail, multi-tail has 
some other nice features, too, I do find the syntax a little 
cumbersome, though. After you’ve run ‘fink install 
multi tail' or ‘port install multitail*, go check it 
out with: 

multitail 1 /var/log/system.log -I /var/log/mail.log 
Very, very handy. 

Another program that's great for viewing log files is less. 
Now, most people think of less as a better more, or vi-withouT 
the-editing. Did you know that less can also follow a file? One 
thing that I love about using less to follow a file is highlighting. 
Let's say you're troubleshooting an e-mail issue for one user. On 
a busy server, the mail log fills up and scrolls away pretty 
quickly. Here's what you do: Run less 

/var/iog/mail. log. This just brings mailJpg into the buffer 
of less. Search on the user’s login id. For example, you’d type 
/stevej (that's forward slash, then “stevej”). less will then 
jump to the first occurrence of Ystevej* and highlight it. 
Something like this line. 


ttov 6 05:16:45 xtc post. fix/smtpd [4817] : 59D955B7E49: 
clients opgun. apple, com [12.34,56,234] , sasl_inethod“CRAH-!lD5, 
easl_U8ernaHe*stevej 

Now, type F (that's a capital F). less will tell you that it is 
"Waiting for data... (interrupt to abort)” and start following the file, 
displaying new lines as they’re added to it. Interrupt is comrol-e As 
new lines are added, any occurrences of i4 stevef will also be 
highlighted. This can be of tremendous use in spotting a line you're 
looking for. If you do see something useful scroll by, just hit 
commands, and then use the arrow keys or control-b (back one 
page), and control-f (forward one page) lo navigate. When you're 
ready to follow again, just press shift-F. 

The last w r ay that I'm going to describe is an Apple-specific 
method. As I mentioned, syslogd in OS X is actually an Apple 
creation more properly called asl, the Apple System Log. In all 
other syslogd implementations you find, a message comes into 
syslogd, gets processed and ultimately written to the right file - 
end of story, asi does this, too, but then takes the extra step of 
writing all entries to a backing store. In this case, 
/var/log/asLlog, but this may change in future releases. This new 
syslogd-is-really-asl setup appeared in 10.4, so, don’t go trying 
this on your Panther box. 

That explanation is leading me to this: the syslog 
program. Note the lack of a trailing *d\ and the fact that you’ll 
only find this on OS X machines. OK, try it: type syslog and 
press return. You'll get a screen lull of log entries that looks like 
you just typed cat /var/log/system. log. ft), what’s the 
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point? The syslog program can follow the entries, similar to 
less. The "-w" switch will wait for new daLa, and display it as 
it arrives. It'd be nice if, like tail, we saw a few previous entries 
as well, but syslog stoically sits there, cursor on the line below, 
OK, l can do this with less, what else? 

Remember that backing store? Entries are actually 
written in there in a raw, kcy/value pair listing. To see that 
format, we override the default 'standard' format using the l - 
F’ (capital F) switch. Try typing syslog F raw- Looks a 
little different this rime, doesn’t it? You can also use the M J1 
switch to define a custom format tor your purposes - no awk 
required! Try this: 

syslog F k $Time $(Sender)t$£PID)J: ^Message' 

This basically just drops the hostname from the standard format. 
Useful, if the log you Ye viewing could only lx: from one host, 
and you want U> focus on the other details. 

While not quite as good as multi tail, by default, 
syslog reports on anything, arriving via the syslog 
mechanism. This is very useful in conjuction with the -w 
switch. Of course, unlike multi tail, you cannot choose to 
watch arbitrary files. 

Overall, Apple's asl implementation gels more interesting 
the deeper you dive into it, l! can Filter the outout according to 
your criteria; 

syslog k Sender postfix 

...to see only messages generated by postfix. It also has a full 
POSIX API, allowing apps to log to and search the asl data store. 

All of that said. I rarely, if ever, use syslog to watch logs. 
Give me the flexibility and portability of tail, grep and less 
- that's pretty much all you need. Add to it the simple 
unfamiliarity, newness and slight clumsiness of syslog, 
well...perhaps we'll see more in 10,5. 

What Now? 

What alxHit all of those other logs 1 pointed out earlier. 
Take a look in /library/logs. You should see something similar 
to the following: 


dtvxrvxr-x 

1 
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admin 

102 

Apr 

28 
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admin 
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5 
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a 
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admin 
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19 
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rw TV TV 

1 

root 

admin 
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2 

15:04 Software 

ttpdare.log 
-rv-r-r- 1 

root 

adoin 6910 Ocl 19 

1 10 

1:31 pantc.log 


(If you also have a memberd_dump.log, it's because you, or 
someone on your machine, ran memberd -1 at some point), 
All of these entries should look relatively familiar. The thing 
to note is that many are directories, each containing multiple, 
though related, log files. These files are ideal candidates to 
view via tail or less. 


When you start going through these logs, you’ll find that 
some logs are more useful than others. Sometimes, but not 
always, you can make a seemingly not-useful log very 
useful! How? 

Some programs let you set the level of logging verbosity. 
Here's where people unfamiliar with Unix are going to say, 
"see! That's why I hate Unix!" The fact of the matter is, a) it’s 
up to the application, how much or how little it will log, and 
if it wilt let you alter that amount, and b) each app handles 
this in its own way. There is no single mechanism that allows 
you to alter the logging level for any given app. 

IF you’re using OS X Server, Server Admin will let you 
alter the log level of most services. Key here being most. If 
you’re using plain Y>1 OS X, you have to do it yourself. Doing 
it by hand can be better in either case as many programs 
have logging options that Server Admin won't let you set 
anyway. 

Samba Ls a great example of many of the topics that 
we've discussed so far: it can log via syslog, its own 
mechanism or both. Additionally, you can configure the 
detail of rite logs from minimal to very detailed. You can get 
mure Information right on your own disk at 
file :///usr/shore/* wert/ using_samba/ch06.html, but 

here’s the gist: In .samba's /elc/snib.conf file, the following 
entries configure logging: 

log level: sets the detail of the log. Ranges from 
1 (minimal) to 10 (extreme!). 

log file: Where to store the logs file on disk. 

max log size: Max size in Kb before samba rolls the log. 

debug timestamp: Show lime stamps in the logs? Values 
of "yes” or “no”. 

syslog: Send log entries to syslog? Value is a number that 
represents the syslog level - values of or below the 
number you specify are sent to syslog. Anything higher is 
only sent to the samba logs. 

syslog only: says what it does, does what it says. Set to 
"yes”, you won't see any entries in the samba logs. 

By default with OS X, samba does not log through 
syslog. This is the primary reason I stick with tail, 
grep, and less as my log analysis tools of choice. 
Samba also does something pretty cool with its conflg file: 
while most programs require a reload to pick up 
alterations, changes in /eLc/smb.conf file are picked up 
every 60 seconds - no reload required! (This can be 
dangerous too - always work on a copy of smb.conf, 
check it with testparm, keep the good one on hand just in 
case, and then move the copy into place.) 
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My other favorite non-system Jog log is the debug log 
generated by Directory Services (although Directory Services 
does log via a si). I mentioned this in the August 2006 Mac in 
the Shell column, but it bears repeating. Find Directory 
Service’s logs at /Library/Logs/DirectoryService. To 
increase the verbosity, send the Directory Service 
process a USRI signal: killall -USR1 
Directory Service. Now have a gander at your 
/Libra ry/Logs/DirecloryService/DirectorySe rvice.se rverJ 
og file (or, use syslog -k Sender Directory Service - 
perhaps even with the -w flag). 

Conclusion 

Understanding how to read and monitor log files can 
make troubleshooting easier More importantly, it is a 
harbinger of issues, before your users complain. For 
something that's just baked into me at this point, t tend 
to cake logs for granted (just a little). Even 1 didn't realize 
that this topic was so deep and that Fd write this much. 
Hopefully, the importance of logs, and ways you can 
make your life easier with them is much more clear now. 
There are even a few tilings I just couldn't touch on this 
month regarding logs, as they really deserve more 
attention. So, next month (to my surprise), 111 be 
discussing my favorite Jog monitoring utilities. You can't 
stare a monitor watching logs 24x7, right? But, a 
computer can. 

Media of the month: Neal Stephenson's 
Cryptonomicon. An ‘oldie' (1999) hut goodie. Now that 
it comes in paperback, it’s even that much easier to 
read! Despite the Neal Stephenson book-ending-curse, 
Cryptonomicon is a great read, incredibly prescient; 
you'll recognize many of the elements, and ultimately 
learn something (especially if you continue on to the 
Bruce Schneier penned appendix!)* 

January! Happy New Year, and Happy Mac World! If 
you’re attending the show, please stop by the MacTech 
booth! If you picked this issue up while at the booth, stop 
back often and please say hello to the MacTech staff and 
authors that will be doing the same. 


Till 
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Jumbo Frame Networks 

Tap into extra Ethernet Speed 
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By Steve Modica 


Approximately one year ago, Apple introduced its first dual 
Ethernet G5 PowerMac, The system sported an internal 
Broadcom chip that provided the user with two high-speed 
Gigabit Ethernet ports. 

Why would Apple include a second Ethernet port on their 
new PowerMac systems? One reason (probably the most 
obvious) is for Xsan support. To add a system to an Xsan storage 
network (or almost any clustered filesystem network), the system 
must he connected to the Fibre Channel based storage, its normal 
internet connection, and a dedicated “Meta-data" network. 

On die previous generation of PowerMac’s, this would 
require the customer to purchase an extra Gigabit Ethernet NIC 
(network interface card), which uses up one POX or POE slot 
and requires the user to open up the machine to install the 
device. When you consider die extra Fibre Channel card ( which 
may have l>een ordered directly from Apple), you’re now down 
to one free PCI slot to house your high-speed video capture or 
other application specific devices. 

Given the minimal price premium for going to a dual port 
Gigabit Chip from a single port, adding that second connector 
was a no-brainer for Apple. 

Xsan and clustered fitesystems in general, have a lot of 
promise. Systems can be attached directly to the shared storage 
using Fibre Channel, and the Ethernet based “meta-data" 
network is used as the traffic cop. It assures lhai multiple 
systems aren't modifying the same filesystem structures 
simultaneously. 

The problem with these new filesystem technologies is the 
entry point cost. Purchasing an Apple XRA1P is quite 
economical given their cost per byte ratio (one of the lowest in 
the industry), but when you add in the cost of a Fibre Channel 
switch, Fibre Channel adapters for each machine, additional 
Ethernet ports for the m eta-data network and the software 
licenses, the cost begins to approach $30,000 for even the 
smallest network. When compared to even high-end NAS 
storage devices, the choice is easy. 

So assuming you are one of the many 5-10 system shops 
that simply can't justify a $30,000 entry point for storage, but 


you've paid for all of these great PowerMac and Mac Pro 
systems with second Gigabit Ethernet ports, what can you do to 
take advantage of them? There's nothing worse than buying 
something and leaving it sit idle, especially when shared 
network performance is one of the most common complaints at 
small shops, 

One very common use of these extra ports is to create a 
dedicated storage network that uses Gigabit Ethernet’s built-in 
“jumbo frame" technology to speed up the transfer of data, 
while reducing the amount of rpu overhead created when 
transferring that data. 


Basic SAN Configuration 



Figure 1. 

A configuration like this can significantly improve network 
performance for file-transfers, captures and downloads, while 
freeing the “normal" office network for tilings like email, web 
browsing and DHCP services. This setup wilt also Increase the 
amount of CPU cycles available on the server and the clients for 
local image processing — a big win for everyone in the office. 

What are Jumbo Frames? Seven years ago, when GigabiL 
Ethernet was just becoming available, processors were a lot 
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A High Performance Video Editing Configuration 
on a Modest Budget 



Figure 2. 

slower than they are today. Vendors weren’t crowing about how 
many Ghz their systems were clocked at, 'fhey were still working 
on hitting the lGhz mark! These new ‘'high-speed* Gigabit 
adapters were expensive and quirky. Finding adapters (which 
typically ran $1 “>00 or more) that worked with all your platforms 
and a switch tliat worked with all your adapters was no small task. 
During this period, a typical Gigabit Ethernet adapter would 
easily eat up an entire CPU just for interrupt processing. It was 


rare to see a Gigabit adapter perform at “line rate” (IE 1 Gb). More 
typically, adapters would get between 400 and 6O0Mbits/sec, This 
is still plenty good, but it must be remembered that while 
maintaining these rates, your machine wasn’t doing anything else. 

Enter the notion of “Jumbo 
Frames" 

Ethernet (and all of its add-on features) are defined as 
IEEE 8023- This spec includes things like autonegotiation, 
link aggregation, lGMbEthemet, lOOMb/EtherneL and even 
lOGb/Ethemet. Ihe spec defines the size of an Ethernet 
frame as 1500 bytes - typically somewhere between i486 and 
1514 bytes depending on the platform. 

Receiving 1 billion bits of data adds up to 83,333 packets 
per second. Theoretically, each one of these packets requires 
the CPU to stop what its doing, receive the packet from the 
Gigabit card, process the headers, and provide the data to die 
waiting application (you). 

At 83,333 packets per second, most of the CPUs time is 
spent context switching. It's constantly saving and recalling 
what it was doing just prior to processing your last packet No 
real work is getting done. 

Vendors quickly realized that unless they wanted to wait 
for processor and bus speeds to catch up they wouldn't sell 
many cards, dliey needed a solution that would allow their 
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products Lo work on the slower processors available at that 
time, Jumbo frames provided one such solution. 

Rather than moving data in 1500 byte chunks, they 
allowed their cards to use much larger packets. Some 
vendors supported 16384 bytes, others supported 
smaller numbers. The “de facto* standard was 9000 
bytes. 

At 9000 bytes per frame, the packet processing load is 
reduced by a factor of 6 (13,888 packets per second). The 
CPU has 1 /6th the number of headers to process and 
theoretically, the number of interrupts to handle. 

Today, all but the very cheapest switches support 
jumbo frames and switch ports for Gigabit are well under 
$100 per port. This makes it extremely easy and 
economical to create a dedicated jumbo frame network. 

Benefits 

1. I laving a separate network means less bandwidth 
contention for critical operations like captures or online 
editing. 

2* Jumbo frames allow local systems to have more 
CPU cycles available for tilings like Final Cut Pro, 
improving the users experience running the application, 

3. A jumbo frame network can support a larger class 
of systems including Apple Maebook, Macbook Pros, Mac 
Minis and iMacs. 

4, Jumbo frames can be used to access “storage over 
Ethernet" devices like iSCSI and AoE RAIDS, such as those 
designed by companies like 2 Degrees Frost, These 
products eliminate typical bottlenecks found in 
client/server networks. 
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Conclusion 

Having extra Gigabit ports on your machines makes 
using jumbo frames easier than ever and the benefits are 
tremendous. All small video capture and post houses, 
audio and pre-press shops should consider this simple, 
elegant solution to improve their network without 
breaking the bank. 
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operating systems to the company. Prior to founding STC, he worked at Silicon 
Graphics Inc. managing a group of devke driver engineers and managing thkd 
party vendor relationships, for the four years prior to joining SGI, he owned and 
operated HPC Consulting; a company specialized in customizing corporate 
networks. Mr. Modica attended Wayne State University in Detroit on a Merit 
Scholarship and received Ids degree in Electrical Engineering in 1992. 
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Laptop Hard Drive Speed 



4200, 5400, 7200 RPMs... does it really matter? 



RPMs: Are They Important? 

It used to he that pretty much the only choices you 
had on laptop hard drives were size. But nowadays, 
there are a number of size choices (with larger sizes 
going from 100 to now 200GB), a couple of interface 
choices (FATA vs, SATA), and a few speed choices 
(4200, 5400 and 7200 KPM). As most 2.5 inch drive 
purchasers will tell you, there's a trade off between 
speed and size. You can't get the largest drives in the 
fastest speed ... in fact, they are almost inversely 
proportional. 

For most laptop drive purchasers, the question 
becomes “how important are RPMs?” and "will I notice 
a difference?” With those questions in mind, we set out 
to do some real world testing, and see what we could 
find ouL, 

Hitachi’s Offerings 

For the test, we used an older FowerRook G4 running 
at 1.67GHz. We used the C l to make the differences 
more apparent, but in general use, we fount! the G4’s 
results to hold proportional anti consistent with all Mat- 
laptops, including the Core Duo and Core 2 Duo 
machines. Some overview information on these Hitachi 
drives - skip to the next section if you are just interested 
in the test results. 



Figure 1. Hitachi Travelstar Drive 

Travelstar 7K100 and Travelstar 5K10G are part of 
HitadiTs range of 2.5-inch hard drives. These drives are 
available with either the Parallel (“old-school") ATA (ATA-6), 
or Serial ATA interface. Native SATA implementation offers 
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throughput at 1.5 Gbits/sec, and supports Native Command 
Queuing (NCQ), Hot Plug, Staggered Spin-up, Link Power 
Management, and other SATA extension features to meet the 
design requirements of single drive systems, ns well as 
multiple drive architectures. (Yes. we realize that the 'hot- 
plug 1 feature is of little use tor an internal laptop drive...) 
The optimized Femto-bascxl actuator/suspension system of 
the Travelstar 7KHXJ and Travelstar 5K10G allows them to 
withstand 300 and 1,000 Gs of operating and non-operating 
shock, and to last for 600,000 load/unioad cycles. 

The Travelstar 7K100, a series of 7200 RPM 2.5-inch iiard 
disk drives, is available in capacities of 60, 80, and 100 GB 
witli 3,4, and 4 data heads respectively and 2 data disks each. 
'I he maximum areal densities of 60, 80, and 100 GB hand 
drives are 66, 66, and 81 Gbits/sq, inch respectively. The 
sector size in 7K10G .series of 2.5 inch hard drives is 512 bytes 
with 24 recording zones. Data buffers of the 7K100 series is 8 
MB wiih latency average of 4.2 ms. Average time Ls 10 
ms Tor a read cycle, and 11 ms for a write cycle. Track to track 
seek time is 1 and 1.2 ms for a read and write cycle, 
respectively. Full stroke seek time is 18ms for a read cycle, 
and 19 ms for a write cyde. The Travelstar 7K100 lias a media 
transfer rate of up to 625 MB/sec, and power consumption of 
0.85 W in low power idle mode. Power requirements of the 
7K100 series are +5VDC (+-5 %) with power consumption of 
5.5, 2.3, 2, 2, 1.1, 0.2, and 0.1 W in startup, seek, read, wiite, 
active idle, standby, and sleep mexfes respectively. The 


operating and non-operating temperature ranges of 7K100 
series are 5 to 55 degrees C Lind minus 40 to 65 degrees C 
respectively. Dimensions of 7K1Q0 series hard drive are 9.5 
mm height x 70 mm width x 100 mm depth. Hard drives in 
the 7K100 series are 115 grams in weight 

The Travelstar 5K100 is a series of 5400 RPM 2.5-inch 
hard disk drives, available in capacities of 40 to 160 GB with 
2, 3 t 4, and 4 data heads and 1, 2, 2, and 2 data disks 
respectively. The maximum areal densities of 40, 60, 80, and 
100 GB hard drives are 70, 70, 70, and 86 Gbits/sq. inch 
respectively. The sector size in 5K100 series of 2.5- inch hard 
drives is 512 bytes, with 16 recording zones. Data buffers of 
the 7K100 series are 8 MB with latency average of 5.5 ms. 
Typical average seek time Ls 12 ms. Travelstar 5K1QQ has a 
media transfer rate of up lo 493 MB/sec, and power 
consumption of 0,60 \V in low power idle mode. Power 
requirement of 5KJ.0Q series is +5VDC (+-5 %), with power 
consumption of 5, 2, 2, 0.85, 0.2, and 0.1 W in startup, read, 
write, active idle, standby, and sleep modes respectively. The 
operating and nonoperating temperature ranges of 5K100 
series are 5 to 55 degrees C and minus 40 to 65 degrees C 
respectively. Dimensions of 5K100 series hard drive are 9.5 
mm height x 70 mm width x 100 mm depth. Hard drives in 
the 5K100 series are 95 and 102 grams in weight. 

Both series of drives feature Enhanced ABLE (Enhanced 
Adaptive Battery Life Extender), a power-management 
technology that dynamically selects the appropriate mode to 
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minimize power usage, and help preserve Ixutery life, when 
the disk drive is idle. Both series of 2.5-inch hard drives 
come equipped with Enhanced Error Correction Code tor 
ensuring data integrity, and Fluid Dynamic Bearing (FDB) 
motor for quiet operation. These hard drives also feature 
TrueTrack, w hich is a suite of advance servo technologies 
that enable hard drives to maintain tme tracking accuracy of 
the heads despite disk shift from shock or vibration. The 
drives are also RoHS compliant. Typical suitable 
applications for Travelstar 7K100 and Travelstar 5KIOO 
include, notebook and tablet PCs, gaming devices, compact 
desktop systems, graphics and CAD workstations, external 
storage solutions, and video editing and surveillance. 

These drives range from about $50 60 up to $200-250, 
depending on the model and size. For more information 
visit: hftp://www.hitachigst.com 

The Tests 

There were two classes of tests that we ran — shorter 
and longer ones. 'The longer tests included the lime it 
took tor booting to start after powering up, boot time, 
fixing permissions, a complex search in Eudora email, 
import into FileMaker, and having Safari open up many 
windows. The shorter tests included a file copy, 
launching Dashboard, launching Eudora, Safari and Word, 
In short, all the tests were not based around spec's, but 


around real world operations. The system was idemical 
on both, as were the contents of the drives. 

The Results 

Numerically, there was a noticeable difference* the 
7200 RPM drive was 25-40% faster. The charts give you 
more detailed information. 

Longer Tests 
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Figure 2. Longer Tests, 5400 vs. 7200 RPM 
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As a user, what's more important is how ii feels. And, 
there was no doubt about it ... the 7200 RPM felt 
considerably snappier and more responsive than the 5400 
RPM drive, and while not included in Lhe lest, ihe 4200 
RPM drive would have shown an even bigger difference. 



Conclusion 

There's no question in our testing that the faster 
drives are noticeably faster. So, the question for you as 
you choose your drive is, “what's your priority?” If size is 
more important than speed, then go with size, but 
remember that not every operation will be as fast as your 
machine could make it. If speed is more important, then 
definitely go for the 7200 RPM drives in the smaller sizes. 
5400 RPM drives are really the contemporary bare 
minimum speed you should settle for 

;a\ 
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Juniper/Netscreen 

Protection 

Today’s big bad world presents its 
challenges... 


The Dangers 

For whatever reason, there's a group of people out there in 
the world who think it’s tun or right to poke around and disrupt 
networks that are not theirs. As a result, we have more secure 
networks today that include routers and switches, firewalls, and 
VPNs (virtual private networks). 

One of the biggest brands in the security business is 
NetScreen, which is part of Juniper Networks. Juniper has a 
variety of offerings, but we're going to focus on three products: 
the Net Screen 25, the SA 2000 and the NelScrecn 5GT Wireless. 

Netscreen 25 

The NelScrecn 25 (and the 50) are security appliances. 
These are integrated devices that target the enterprise “branch" 
office as well as remote offices, and small to medium-sized 
businesses. The idea is that this Ixix protects the perimeter of 
your network from unwanted activities. 

The NetSereeo-25 offers 100Mbps of firewall and 20 Mbps 
of VPN performance. U can support 32,000 concurrent sessions, 
and 125 VPN tunnels. The NetScreen-50 oilers even greater 
capacity: 170 Mbps of firewall and 45 Mbps of 3DBS or AES VPN 
performance, with support for 64,000 concurrent sessions, and 
500 VPN tunnels. 



NetScreen-2 5 


The most important feature to the NetScreen-25/50 is that 
you plug it in, and it works. With little configuration, this box 
will immediately start protecting your network with various 
deep inspection firewall services, denial of service protection, 
and more. 

This is a very capable box, and we watched it prove it's 
worth in stopping attacks cold that came from all over the w orld. 
It’s amazing how many times networks get attacked, and die 
NetScreen-25 just deals with it ... cleanly and transparently. 

Finally, take your pick of interfaces to match your managing 
style: Web l IT, CLI, or Net Screen's Security Manager central 
management system application. 

At $2,500 and up, street price, you’ll more than make up for 
this in time on your first attack, or in creating VPNs. See 
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Juniper Networks 
Secure Access 2000 

The Secure Access 2000 (SA 2000) SSL VPN was 
introduced to rhe Juniper Network Secure Access series in 
2005. It utilizes the SSL security protocol, a secure access 
transport mechanism available in all standard web browsers. 
This enables small to medium-sized companies to provide 
controlled remote and extranet access to employees, 
partners, and clients with no infrastructure changes, DMZ 
deployments or software agents. 



Juniper SA 2000 

Apart from lowering the total cost of ownership, this 
function allows companies to secure access to the corporate 
intranet, enabling administrators to restrict access to various 
employees, contractors or visitors, based on the information and 


resources they need. The SA 2000 is based on industry-standard 
protocols, therefore its investment can tx: leveraged across many 
applications and resources over time. It also boasts extensive 
directory integration (including LDAP!) and advanced software 
feature sets such as multi pie hostname support and a 
customizable user interface. 

The SA 2000 series provides complete end-to-end 
layered security, including endpoint client, device, data and 
server layered security controls. The numerous security 
options from the end-user device to the application data and 
servers, also covers coordinated threat control with Juniper 
Network's 1DP product line. Juniper's endpoint defense 
initiative incorporates native functionality, client and server- 
side API's (created in partnership with best-of-breed 
endpoint security vendors), and advanced malware 
protection capabilities. While this keeps your Mac systems 
secure, it really shines for those initially difficult-to-secure 
Windows machines. 

With the native functionality, client computers can be 
checked at the beginning and throughout the session to 
verify an acceptable security posture requiring or requesting 
network ports. Files and processes can also be checked, and 
their authenticity validated with MD5 checksums. The native 
host checker also performs security and applications checks, 
and carries out pre-authentication checks and enforcement. 
Enterprises are also enabled to write their own host check 
method to customize policy checks. Again, this targets 
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Windows machines, its they need this kind of help and 
monitoring. 

The SA 2000's access privilege management capabilities 
provide dynamic controlled access at the URL, file, application 
and server-level, This is based on a variety of session specific 
variables that include identity, device, security control, and 
network tmst level 

Streamlined manageability of Juniper's SA 2000 provides 
role-based delegation of administrative tasks and a central 
management option for more unified administration. There is 
also a self-service feature for users that lowers help-desk 
support costs. Auditing and logging is fine-grained, and there 
are three different secure access methods to allow 
administrators provision by purpose. The streamlined feature set 
dial die SA 2000 comes with would enable an enterprise to 
deploy secure remote access as well as a basic customer/partner 
extranet or secure intranet. 

A cluster pair deployment option for the SA 2000 ensures 
high-availability across the LAN and the WAN. 

An advanced license feature for the SA 2000 provides additional 
staie-oLthc-art features tliat would satisfy tJve needs of other a implex 
deployments of varied audiences and uses, including junipers Central 
Manager, You'll find the ,SA 2000 Base 1 System for alxiul $2,(XX), witli 
the Advance License at an additional exist. More information at 
http: //www, junipe met/ products_and_services/ssl_vpn_secure_a cc 
ess/secu re_acceis_2000/ 


NetScreen-5GT Wireless 
Firewall/VPN 

Ok, so voti have your VPN heart with the SA 2000, and your 
perimeter firewall with tile NetScreeo-25, what about remote 
office security? That's where the Net Screen-SGT comes in. The 
NetScreen-5GT is an enterprise-class network security solution 
for remote office security, 

The NetScreen-SGT Wireless Ls a part in a series of firewall/VPN 
line of products offered from Junior. It is part of an integrated 
security solution combining stateful firewall, deep inspection 
firewall, IPScc VPN, antivinis and web filtering for securing a small 
remote office, retail outlet, or broadband telecommuter. 

The NetScreen-AGT is specifically aimed at those that want 
to run an 802.11 b/g wireless network in a secure setting. But 
it gives you some fairly sophisticated features including 
restricted security zones (teg., home vs, work zones), 
configurable wireless security zones (each with their own SSID 
for different types of users), redundancy for high availability, 
support for dual connections, fast failovers with redundant VPN 
tunnels and VPN monitoring. 
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NetScreen-5GT Wireless: Front and Back 


Al a street price of around $1,000, ifs a great, integrated 
solution for those that need a secure remote office or home 
office, and especially one that wants seamless VPN 
integration with an SA 2000, For more information, see 
http://www.juniper.net/ pro ducts/inte grated/ns_5series,hfml 


Conclusion 

You need to secure your network - one way or another If you 
aren’t, you’re asking for trouble. Once you do secure your network, 
nm some reports, you'll realize how often people are trying to break 
in. Miss one patch of some piece of web server software? They will 
break in. 

Juniper has a set of world-class products liiat will protea you 
without you needing to be a security expert (although, you do need 
to know wjiai you're doing on some level - there's no magic here). 
Whether you configure them to the hilt, or use them in a more plug¬ 
in-play environment, you'll have a level of protection that will give 
you peace of mind. While you may not want to pay $1,000 for a 
router, or more for VPN and firewall software, you are protecting 
your network for a reason, juniper's offerings will give you an end- 
to-end solution, that works well with tlte Mac. 


Jill 
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» 45 Mbps of sustained throughput 
» Capable of 5.3 and 5.8 GHz 
» Point-to-point, OFDM 
» Up to 40-mile range 
» Adaptable Rate Modulation 


Wireless Connectivity © Powered by Trango 


Trango Broadband Wireless 

A division of Trango Systems, Inc 


www.trangobroadband.com 

Phone: +1 (858) 653-3900 


trangobroadband 

WIRELESS 



Sound Studio 3 SoundStudio3 


By Marianne Shilpa Jacobie, MacTech Staff Writer 

Sound Studio 3 from Freeverse is an easy-to-use Mac OS X 
application for recording and editing audio digitally. It can he 
used to digitize tapes and vinyl records, record live 
performances, create mixes with crossfades, tweak the levels, 
apply digital effects, and save in all major audio file formats. 
Sound Studio 3 can also be used to record professional 
sounding Podcasts, and oilier audio dialog. Other typical 
applications of Sound Studio 3 are lectures, voice-notes, 
sermons, and performances. 

Recording features of Sound Studio 3 include multi-track 
support that enables layering stereo sounds and saving in 
interleaved format, Audio Unit plug-in effect support, saving 
in MPEG-4 AAC (advanced audio coding) m4a format, saving 
in MP3 when the LAME framework is installed, Autoinator 
support, 24-bit / 96 kHz sample quality, in stereo or mono, 
low latency monitoring using Core Audio, and automatic 
recording starting and stopping based on timers or audio 
levels. Freeverse recommends iMie from Griffin Technology 
for use with Sound Studio 3* 




Sound Studio 3 comes with some advanced editing 
functions such as sample-accurate edits, markers (cue points) 
with text laliels, time ruler with units for video and film and 
copy-and-paste editing. 

This product also comes loaded with a cool effects 
portfolio. It features support for Audio Units, pitch adjustment, 
reverse audio, and Tone, PM, and noise generators. The 
"dynamics” group of effects includes compressor, expander, 
and noise gate. Equalization features include graphic FQ, low 
pass filter, and high pass filter. Volume effects comprise, 
amplify, fade in/out/speda], and normalize features. Finally, 
there are the ever-present delay effects, including chorus, 
Hanger, echo, and reverb, 

Sound Studio 3 Incorporates Ixisic audio re pair features. Available 
functions ate interpolation, silence. DC offset, and swap channels. 
Ttiese functions tun also lx* used to repair dicks and peps - typically 
found on older recordings or material brought in from vinyl 

Sound Studio 3 supports 
a variety of file formats such 
as MFF (.aif) and AIFF-C 
Caifc) with compression 
including IMA 4:1, AAC and 
MP3 (importing only), Sound 
fX^igner II, Wave (.wav, PCM 
only), and Tab-delimited text 
(export only). Sound Studio 3 
requires Mac OS X v 10.3-9 or 
later and PowerPC G3 500 
MHz or faster with 512 MB 
RAM. It also requires a minimum of 1 GB hard drive space for storing 
audio data. 

Our conclusion? This is an easy-to-use, but powerful 
application that gives you the ability to do intricate sound 
editing yielding professional results. It certainly fills a need 
for basic editing when ProToos or Logic would be overkill. 
Sound Studio 3 is priced at $79.95 1 and available from 
http: //www. f re e v e rs e . com/ s o u n d sfu d io/. 
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Sound Studio: Editing 
Window 




















imagine, inspire, ignite. 

Conference: January 8-12,2007 
Expo: January 9-12,2007 

The Moscone Center 
San Francisco 


Macworld 

Conference & Expo” 



r 1 

Register 

Priority Code: A-MT2 

TODAY 

L_ J 

ma c wo rl dexpo.co m/reg ister 


Give your professional talent room to grow at an event that's as stimulating as it is creative. Get inspired at Macworld 
Conference & Expo 2007. You'll immerse yourself in five exciting days of the largest gathering of Mac industry experts, pundits 
and enthusiasts. Plus, cultivate new skills and get the indispensable tools you need to ignite your imagination and fuel your 
Mac soul. Macworld Conference & Expo. Imagine the radical possibilities. 















Height and Angle 
FootRester 

No matter how you slice it, people are built differently. It's 
important for people to he not only comfortable but to support 
their body in the right way. Part of thaL is foot position, and 
having your feel, legs and body at Lite right angles. 

If you are looking for a footrest to attain a proper 
ergonomic position while at work, the WorkRite Ergonomics' 
Height and Angle FootRester may be your answer. The 
FootRester has both height and angle adjustment that locks into 
place automatically. And, the platform rcx:ks tack and forth lo 
change with your body position. 

I he platform is 23 inches wide and II ? inches deep, and It is 
adjustable in increments of 1 inch from 4 inches to 13 inches of 
maximum height from the floor Ihe FootRester is constructed of 
a heavy gauge steel frame and 3/8-inch thick composite plastic that 
can withstand lough use. 

We’ve used the FootRester for a few months, and found 
it to increase comfort and improve the ergonimk: position. 
Better yet, it only took a day or so to be so comfortable with 
it t that we forgot about it. Height and Angle FootRester 
weighs 15 lbs. 



Cost: $152 

URL 

http://www.workriteefgo.com/prioducfe/produdrnam. asp? Fam I [>=2 5 

-MacTech Staff 

Till 


R A D I 0 T 0 P E 

TECHNOLOGY CONSULTING 



Aligning business goals and technology. 
Bringing enterprise solutions to 
small end medium businesses. 

email: info@radiotope.com 
http://wuvw.radiotope.com 


When your customers 
need a helping hand, 
don't you want to be there? 


With Mac HelpMate Pro, 
you're just a click away. 
www.MacHelpMate.com/testdrive 

Mac HefpMate Professional features: 

* Zero-con figuration screen sharing (no IP address, no router tweaking necessary), 
it works through 90% of firewalls and NATs. Reach anyone in the world wherever 
they are, wherever you are ... 

* Your company's image and logo on the splash screen of the application reinforces 
your brand,i services and sales offerings as well os generates new opportunities 

* Automated maintenance tasks create billable subscription-based services 

-One unlimited license covers installation for all of your customers'workstations 

* Crass platform; Mac - Mac Mac - Win, Win - Mac and Win - Win 

Mac HelpMate Professional ™ is a product of MOST Training & Consulting 
www.macworkshops.com 
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Lobotomo Software 

Christoph Nadig and Pascal Frdburghaus 

http://www Jobotomo.com 

Company Info: 

Lobotomo Software is not really a company, but a hobby 
creating cool tools thaL are missing in OS X (until we 
make them). 

How long have you been doing what you do? 

We started Lobotomo Software in fall 2003 - when we 
thought of a bunch of tools interesting enough to share 

Your first computer: 

Tfie first computer we put our hands on was a 
Commodore VIC-20. This was followed by a number of 
fully or semi home built systems with not particularly 
mainstream architectures: 68k, DEC Alpha and PPC 
Thanks Lo Apple we finally made it into Intel World (not 
sure ye! If we should feel comfortable there yet...) 

What attracts you to working on the Mac? 

The Mac is designed from a users perspective, not a 
technical one. This always reminds us to write software 
that gives a user the (rest benefit instead of delivering 
the most fancy technical solution. 


What's the coolest tech thing you've done 
using OS X? 

With WinShartcuiler we bridged the Inferior to the 
Superior. Dirly job, but someone had to do it.., 

Ever? 

http: // www.lobotomo.com/prod acts/ Fan Control 

Where can we see a sample of your work? 

Please have a look at http://wwwJobotomo.com or ask 
Mr. G<x>gle for Lobotomo Software to see how and 
where our software is used 

The next way I'm going to impact IT/OS X/the 
Mac universe is: 

With IFSecuritas 3*0, which will stxm be released in the 
final version, well provide a huge leap forward in 
functionality and user comfort, superceeding competing 
products. Like earlier version of IFSecuritas, version 3,0 
will be freeware. 


88 January * 2007 
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From our server room to yours. 


Small Dog Electronics is the third largest Apple Specialist in the US. We offer over 
4000 Mac-compatible products, including new and Apple Refurbished Xserves, 
Xserve RAID’s, RAM, hard drives, networking gear, and much more. 

We’ve earned our place in the Apple community with our famously superior 
customer service, great prices, and by staying true to the Apple platform. 

We are here to help you. Give us a call, or visit us at Smalldog.com! 

Small Dog Electronics is 100% Mac-based. We’re powered by: 14 Xserves + 4 C4 Servers + 3 T1 lines + 
Heaps of Cisco Routers + 4 Miles of CAT 5 + 13 kW Propane Back-up Generator + 13 Network Cameras + 

1 Firewall + 40 Mac Workstations + 40 Apple Product Professionals + 14 dogs of all shapes and sizes! 



Small Dog 

Electronics 

Always by your side. 

lvww.smalldog.com 800-511-MACS 


^(o-OO off Shipping an yaut 
order / 

&»ip/y enter Coupon Code 
tijpen cpecJt'tna 

out at S/y)cJ/doy jC ev»7 / 
Coupon good throunh S/ 31 /Q 7 


Apple Specialist 


THINGS MADE IN CHINA 
COMPRESSED BY 

STUFFIT DELUXE 

SDfTYWRE H1R mJrc 
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